Draw a world's country
world_heightmapDraws the open country a world document generates (its worldgen block: seed, knobs, regions with their own relief, a ridge) as one greyscale PNG, row 0 north, so a world built with world_apply can be looked at before anyone walks it. area {w, h} makes a block of chunks from chunk (i, j) (w times h at most 25); range [lo, hi] fixes the grey scale in world units. The answer carries the height range, the grey scale used (greyFrom, greyTo, unitsPerGrey) and the name of the country each chunk sits in. A world with no worldgen block is bounded and is refused by name; set_worldgen opens it onto boundless country. Costs 1 unit.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"world": "<world>",
"i": "<i>",
"j": "<j>"
},
"name": "world_heightmap"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| i | Yes | The chunk column (east) to start from; chunks are 128 by 128 tiles. | |
| j | Yes | The chunk row (south) to start from; chunks are 128 by 128 tiles. | |
| area | No | A block of chunks, w by h (each 1 to 25) from (i, j), drawn as one picture. | |
| range | No | Optional [lo, hi] in world units that fixes the grey scale, so separate calls tile on one scale. | |
| world | Yes | The world document, written inline as JSON. It needs a worldgen block to have country to draw. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ms | No | Milliseconds the run took. | |
| job | Yes | The job id; the job tool reads it. | |
| verb | No | The tool that made it. | |
| files | No | Files made, each with a name, type, size and a signed URL. | |
| units | No | Units this call cost. | |
| result | No | The engine's own answer, a JSON document. | |
| status | No | queued when the job runs in the background. |