Set block
set_blockPlace a single block at specified X, Y, Z coordinates, replacing any existing block, with optional block state and NBT data.
Instructions
Place one block, replacing what is there. For more than a handful of blocks use fill_region or build_from_layers. Doors and beds need both halves placed explicitly.
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>",
"block": "<block>"
},
"name": "set_block"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | Yes | Block X coordinate (east is +X). | |
| y | Yes | Block Y coordinate (height; the overworld build range is -64 to 319). | |
| z | Yes | Block Z coordinate (south is +Z). | |
| nbt | No | Block-entity data. The plugin applies only CustomName (containers) and Text1-Text4 (sign lines); other keys are ignored. | |
| block | Yes | Block id such as 'minecraft:stone' or 'oak_planks' (the minecraft: namespace is optional). | |
| block_state | No | Block state properties, e.g. {'facing': 'north'}. Handled specially: facing (north/south/east/west/up/down), axis (x/y/z), half (top/bottom - also for doors and tall plants), shape (stairs: straight/inner_left/inner_right/outer_left/outer_right), rotation (signs, banners, heads: a compass direction such as north_north_east, not 0-15), waterlogged/open/powered (true/false). Any other vanilla property also works (e.g. type=top for slabs, hinge=left, lit=true). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||