Build from text layers
build_from_layersConstruct Minecraft structures from stacked text layers by mapping characters to blocks. Use it for houses, statues, and pixel art; oversized bounding boxes over 100,000 blocks are rejected.
Instructions
Build a structure from text layers, like floor plans stacked bottom to top: character k of row j of layer i becomes block (x + k, y + i, z + j). Ideal for houses, statues and pixel art; use fill_region for big solid volumes. get_blocks returns this same format, so a region can be read, edited and written back. Refuses structures whose bounding box exceeds 100,000 blocks.
Example: palette {"#": "stone_bricks", "G": "glass", ".": "air"} with layers [["###", "#.#", "###"], ["#G#", "G.G", "#G#"]] builds a 3x3 stone ring with a glass ring on top.
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": {
"x": "<x>",
"y": "<y>",
"z": "<z>",
"palette": "<palette>",
"layers": "<layers>"
},
"name": "build_from_layers"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | Yes | X of the west (lowest X) edge. | |
| y | Yes | Y of the bottom layer. | |
| z | Yes | Z of the north (lowest Z) edge. | |
| layers | Yes | Horizontal slices from bottom to top. Each slice is a list of rows from north to south (+Z); each row is a string read west to east (+X), one character per block. Every slice needs the same number of rows and every row the same length. | |
| palette | Yes | Maps single characters to a block id, an object {block, block_state?, nbt?}, or null (leave unchanged). '.' is air unless mapped here. A space always means 'leave unchanged' and cannot be redefined. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||