Read blocks in a box
get_blocksReads all blocks in a Minecraft box and returns palette layers, XYZ indices, or counts for inspecting terrain and preparing edits.
Instructions
Read every block in a box (corners inclusive, any order; at most 100,000 blocks).
The default 'layers' layout returns palette (character -> block id) and layers: one entry per Y
from the bottom up, each a list of row strings from north to south (+Z), each row read west to east
(+X). '.' is air. It is the exact input format of build_from_layers, so you can edit the strings and
write them back. counts gives the number of each block. Keep raw reads small (16x16x16 is plenty);
use layout='summary' or get_height_map 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>",
"y1": "<y1>",
"z1": "<z1>",
"x2": "<x2>",
"y2": "<y2>",
"z2": "<z2>"
},
"name": "get_blocks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x1 | Yes | X of one corner of the box (inclusive). | |
| x2 | Yes | X of the opposite corner (inclusive). | |
| y1 | Yes | Y of one corner of the box (inclusive). | |
| y2 | Yes | Y of the opposite corner (inclusive). | |
| z1 | Yes | Z of one corner of the box (inclusive). | |
| z2 | Yes | Z of the opposite corner (inclusive). | |
| layout | No | 'layers' (default): character palette + layers[y][z] strings, the format build_from_layers accepts. 'xyz': palette indices as blocks[x][y][z], the edit_blocks format. 'summary': block counts only. | layers |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||