Map surface heights
get_height_mapFinds the highest non-air block Y for each column in an X/Z area, returning absolute ground heights (null for empty columns) to plan builds and survey terrain.
Instructions
Find the ground: for each column of an X/Z area, the Y of the highest block that is not air.
heights[z][x] is an absolute Y (null for an empty column): rows go north to south (+Z), entries west
to east (+X). surface uses the same layout with characters from surface_palette. Build on a column
at heights + 1. Scans (area x height) blocks, at most 100,000; narrow y_min/y_max for big areas.
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": {
"x1": "<x1>",
"z1": "<z1>",
"x2": "<x2>",
"z2": "<z2>"
},
"name": "get_height_map"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x1 | Yes | X of one corner of the box (inclusive). | |
| x2 | Yes | X of the opposite corner (inclusive). | |
| z1 | Yes | Z of one corner of the box (inclusive). | |
| z2 | Yes | Z of the opposite corner (inclusive). | |
| y_max | No | Highest Y to scan. | |
| y_min | No | Lowest Y to scan; narrow the range around the expected ground. | |
| ignore_blocks | No | Block ids to treat as empty, e.g. ['water', 'oak_leaves', 'short_grass'] to find solid ground under water or trees. Air is always empty. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||