Tool tree
gradeNot graded
get_player_stateAnswer
Returns the current position, orientation, mode, health, inventory hotbar, and surroundings of the player.
View tool JSON
{
"name": "get_player_state",
"kind": "answer",
"impl": "imperative",
"description": "Returns the current position, orientation, mode, health, inventory hotbar, and surroundings of the player.",
"inputSchema": {
"type": "object",
"properties": {}
}
}move_playerAction
Moves the player in a specified direction relative to facing angle (forward, backward, left, right, jump) by a given distance or steps.
View tool JSON
{
"name": "move_player",
"kind": "act",
"impl": "imperative",
"description": "Moves the player in a specified direction relative to facing angle (forward, backward, left, right, jump) by a given distance or steps.",
"inputSchema": {
"type": "object",
"properties": {
"direction": {
"type": "string",
"enum": [
"forward",
"backward",
"left",
"right",
"jump"
],
"description": "Direction to move."
},
"distance": {
"type": "number",
"description": "Distance in blocks to travel (default 2 blocks).",
"default": 2
}
},
"required": [
"direction"
]
}
}look_atAction
Rotates player camera to specific pitch/yaw degrees, or looks towards a world coordinate (x, y, z), or uses a preset like "turn_around", "north", "south", "east", "west", "up", "down".
View tool JSON
{
"name": "look_at",
"kind": "act",
"impl": "imperative",
"description": "Rotates player camera to specific pitch/yaw degrees, or looks towards a world coordinate (x, y, z), or uses a preset like \"turn_around\", \"north\", \"south\", \"east\", \"west\", \"up\", \"down\".",
"inputSchema": {
"type": "object",
"properties": {
"preset": {
"type": "string",
"enum": [
"turn_around",
"north",
"south",
"east",
"west",
"up",
"down",
"level"
],
"description": "Quick rotation preset."
},
"pitch": {
"type": "number",
"description": "Camera pitch in degrees (-89 looking down to 89 looking up)."
},
"yaw": {
"type": "number",
"description": "Camera yaw in degrees (0 to 360)."
},
"targetPos": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"z": {
"type": "number"
}
},
"description": "World coordinate to aim the camera at."
}
}
}
}set_flyingAction
Controls creative flying state. In creative mode, allows hovering, ascending, or descending.
View tool JSON
{
"name": "set_flying",
"kind": "act",
"impl": "imperative",
"description": "Controls creative flying state. In creative mode, allows hovering, ascending, or descending.",
"inputSchema": {
"type": "object",
"properties": {
"flying": {
"type": "boolean",
"description": "Enable or disable flight mode."
},
"direction": {
"type": "string",
"enum": [
"up",
"down"
],
"description": "Ascend or descend in flight."
},
"blocks": {
"type": "number",
"description": "Number of blocks to ascend/descend (default 3).",
"default": 3
}
}
}
}teleportAction
Instantly teleports the player to coordinates (x, y, z) or by a relative offset (dx, dy, dz).
View tool JSON
{
"name": "teleport",
"kind": "act",
"impl": "imperative",
"description": "Instantly teleports the player to coordinates (x, y, z) or by a relative offset (dx, dy, dz).",
"inputSchema": {
"type": "object",
"properties": {
"x": {
"type": "number",
"description": "Target X coordinate."
},
"y": {
"type": "number",
"description": "Target Y coordinate."
},
"z": {
"type": "number",
"description": "Target Z coordinate."
},
"dx": {
"type": "number",
"description": "Relative delta X."
},
"dy": {
"type": "number",
"description": "Relative delta Y."
},
"dz": {
"type": "number",
"description": "Relative delta Z."
}
}
}
}set_game_modeAction
Switches between "creative" and "survival" modes. In creative mode, flying and instant mining are unlocked. Building works in both modes.
View tool JSON
{
"name": "set_game_mode",
"kind": "act",
"impl": "imperative",
"description": "Switches between \"creative\" and \"survival\" modes. In creative mode, flying and instant mining are unlocked. Building works in both modes.",
"inputSchema": {
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"creative",
"survival"
],
"description": "Game mode to set."
}
},
"required": [
"mode"
]
}
}set_time_of_dayAction
Sets the sun/moon time cycle. Accepts presets like "day", "noon", "sunset", "night", "midnight", or a float between 0.0 and 1.0.
View tool JSON
{
"name": "set_time_of_day",
"kind": "act",
"impl": "imperative",
"description": "Sets the sun/moon time cycle. Accepts presets like \"day\", \"noon\", \"sunset\", \"night\", \"midnight\", or a float between 0.0 and 1.0.",
"inputSchema": {
"type": "object",
"properties": {
"time": {
"type": "string",
"description": "Time string (\"day\", \"noon\", \"sunset\", \"night\", \"midnight\") or a decimal (0.0 to 1.0)."
}
},
"required": [
"time"
]
}
}set_weatherAction
Changes atmospheric weather to "clear", "rain", or "snow".
View tool JSON
{
"name": "set_weather",
"kind": "act",
"impl": "imperative",
"description": "Changes atmospheric weather to \"clear\", \"rain\", or \"snow\".",
"inputSchema": {
"type": "object",
"properties": {
"weather": {
"type": "string",
"enum": [
"clear",
"rain",
"snow"
],
"description": "Weather condition."
}
},
"required": [
"weather"
]
}
}list_available_blocksAnswer
Lists all available blocks in the game with IDs, names, and categories (Wools, Building, Ores, Nature, Lights).
View tool JSON
{
"name": "list_available_blocks",
"kind": "answer",
"impl": "imperative",
"description": "Lists all available blocks in the game with IDs, names, and categories (Wools, Building, Ores, Nature, Lights).",
"inputSchema": {
"type": "object",
"properties": {
"category": {
"type": "string",
"enum": [
"all",
"wool",
"wood",
"stone",
"ore",
"nature",
"light"
],
"description": "Filter category.",
"default": "all"
}
}
}
}list_inventoryAnswer
Lists all 36 player inventory slots, current hotbar slot selection, and item quantities.
View tool JSON
{
"name": "list_inventory",
"kind": "answer",
"impl": "imperative",
"description": "Lists all 36 player inventory slots, current hotbar slot selection, and item quantities.",
"inputSchema": {
"type": "object",
"properties": {}
}
}select_hotbar_slotAction
Selects an active hotbar slot (0 to 8) or selects the slot containing a specific block/item name.
View tool JSON
{
"name": "select_hotbar_slot",
"kind": "act",
"impl": "imperative",
"description": "Selects an active hotbar slot (0 to 8) or selects the slot containing a specific block/item name.",
"inputSchema": {
"type": "object",
"properties": {
"slotIndex": {
"type": "integer",
"minimum": 0,
"maximum": 8,
"description": "Hotbar slot index (0 to 8)."
},
"itemName": {
"type": "string",
"description": "Name of the item/block to find and select in the hotbar (e.g. \"pickaxe\", \"black_wool\")."
}
}
}
}give_itemAction
Adds an item or block into the player inventory (e.g. "diamond_pickaxe", "black_wool", "white_wool", "torch").
View tool JSON
{
"name": "give_item",
"kind": "act",
"impl": "imperative",
"description": "Adds an item or block into the player inventory (e.g. \"diamond_pickaxe\", \"black_wool\", \"white_wool\", \"torch\").",
"inputSchema": {
"type": "object",
"properties": {
"item": {
"type": "string",
"description": "Name of block or tool (e.g. \"white_wool\", \"black_wool\", \"diamond_pickaxe\")."
},
"count": {
"type": "integer",
"default": 64,
"description": "Quantity to give (1-64)."
}
},
"required": [
"item"
]
}
}inspect_blocksAction
Inspects a single block coordinate (x, y, z) or scans a 3D box region around player/coordinates.
View tool JSON
{
"name": "inspect_blocks",
"kind": "act",
"impl": "imperative",
"description": "Inspects a single block coordinate (x, y, z) or scans a 3D box region around player/coordinates.",
"inputSchema": {
"type": "object",
"properties": {
"x": {
"type": "number",
"description": "Center X coordinate."
},
"y": {
"type": "number",
"description": "Center Y coordinate."
},
"z": {
"type": "number",
"description": "Center Z coordinate."
},
"radius": {
"type": "number",
"description": "Scan radius in blocks (0 for single block, max 6).",
"default": 0
}
}
}
}get_target_blockAnswer
Casts a ray from player eyes and returns the block currently targeted, distance, and the adjacent place coordinate.
View tool JSON
{
"name": "get_target_block",
"kind": "answer",
"impl": "imperative",
"description": "Casts a ray from player eyes and returns the block currently targeted, distance, and the adjacent place coordinate.",
"inputSchema": {
"type": "object",
"properties": {}
}
}mine_blockAction
Mines the block at (x, y, z) or the block currently targeted in crosshair. In creative mode, instantly breaks; in survival, breaks and drops loot.
View tool JSON
{
"name": "mine_block",
"kind": "act",
"impl": "imperative",
"description": "Mines the block at (x, y, z) or the block currently targeted in crosshair. In creative mode, instantly breaks; in survival, breaks and drops loot.",
"inputSchema": {
"type": "object",
"properties": {
"x": {
"type": "number",
"description": "X coordinate."
},
"y": {
"type": "number",
"description": "Y coordinate."
},
"z": {
"type": "number",
"description": "Z coordinate."
}
}
}
}attack_mobAction
Attacks or kills the closest mob within reach, or a specific mob type.
View tool JSON
{
"name": "attack_mob",
"kind": "act",
"impl": "imperative",
"description": "Attacks or kills the closest mob within reach, or a specific mob type.",
"inputSchema": {
"type": "object",
"properties": {
"mobType": {
"type": "string",
"description": "Optional mob type to filter (e.g. \"zombie\", \"creeper\", \"pig\")."
},
"damage": {
"type": "number",
"default": 20,
"description": "Amount of damage to inflict (default 20 = instant kill)."
}
}
}
}spawn_mobAction
Spawns a creature/mob ("pig", "cow", "sheep", "chicken", "wolf", "zombie", "creeper", "skeleton", "spider", "enderman") at target coordinates or near player.
View tool JSON
{
"name": "spawn_mob",
"kind": "act",
"impl": "imperative",
"description": "Spawns a creature/mob (\"pig\", \"cow\", \"sheep\", \"chicken\", \"wolf\", \"zombie\", \"creeper\", \"skeleton\", \"spider\", \"enderman\") at target coordinates or near player.",
"inputSchema": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"pig",
"cow",
"sheep",
"chicken",
"wolf",
"zombie",
"creeper",
"skeleton",
"spider",
"enderman"
],
"description": "Type of mob to spawn."
},
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"z": {
"type": "number"
}
},
"required": [
"type"
]
}
}place_blockAction
Places a block at (x, y, z) by block name or ID (e.g. "black_wool", "white_wool", "glowstone", "gold_block").
View tool JSON
{
"name": "place_block",
"kind": "act",
"impl": "imperative",
"description": "Places a block at (x, y, z) by block name or ID (e.g. \"black_wool\", \"white_wool\", \"glowstone\", \"gold_block\").",
"inputSchema": {
"type": "object",
"properties": {
"x": {
"type": "number",
"description": "X coordinate."
},
"y": {
"type": "number",
"description": "Y coordinate."
},
"z": {
"type": "number",
"description": "Z coordinate."
},
"block": {
"type": "string",
"description": "Block name or ID to place (e.g. \"black_wool\", \"white_wool\", \"glowstone\")."
}
},
"required": [
"x",
"y",
"z",
"block"
]
}
}set_blocks_batchAction
Places multiple blocks. Supports animated: true and delayMs (e.g. 20-50ms) so players can watch the AI construct structures in real time block-by-block with sounds, or animated: false for instant placement.
View tool JSON
{
"name": "set_blocks_batch",
"kind": "act",
"impl": "imperative",
"description": "Places multiple blocks. Supports animated: true and delayMs (e.g. 20-50ms) so players can watch the AI construct structures in real time block-by-block with sounds, or animated: false for instant placement.",
"inputSchema": {
"type": "object",
"properties": {
"blocks": {
"type": "array",
"items": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"z": {
"type": "number"
},
"block": {
"type": "string"
}
},
"required": [
"x",
"y",
"z",
"block"
]
},
"description": "Array of block coordinate and type descriptors: [{ x, y, z, block }]."
},
"animated": {
"type": "boolean",
"default": false,
"description": "If true, places blocks progressively over time with real-time sounds so players see the AI building."
},
"delayMs": {
"type": "number",
"default": 25,
"description": "Delay between block placements in milliseconds if animated is true (default 25ms)."
}
},
"required": [
"blocks"
]
}
}clear_areaAction
Clears a 3D rectangular box volume from (x1, y1, z1) to (x2, y2, z2) by replacing it with AIR. Ideal for preparing building sites.
View tool JSON
{
"name": "clear_area",
"kind": "act",
"impl": "imperative",
"description": "Clears a 3D rectangular box volume from (x1, y1, z1) to (x2, y2, z2) by replacing it with AIR. Ideal for preparing building sites.",
"inputSchema": {
"type": "object",
"properties": {
"x1": {
"type": "number"
},
"y1": {
"type": "number"
},
"z1": {
"type": "number"
},
"x2": {
"type": "number"
},
"y2": {
"type": "number"
},
"z2": {
"type": "number"
}
},
"required": [
"x1",
"y1",
"z1",
"x2",
"y2",
"z2"
]
}
}build_shapeAction
Procedurally generates geometric 3D shapes: box, cube, sphere, dome, cylinder, column, wall, pyramid, circle, ring, disc, platform, oval, or ellipsoid (solid or hollow).
View tool JSON
{
"name": "build_shape",
"kind": "act",
"impl": "imperative",
"description": "Procedurally generates geometric 3D shapes: box, cube, sphere, dome, cylinder, column, wall, pyramid, circle, ring, disc, platform, oval, or ellipsoid (solid or hollow).",
"inputSchema": {
"type": "object",
"properties": {
"shape": {
"type": "string",
"enum": [
"box",
"cube",
"sphere",
"dome",
"cylinder",
"column",
"pillar",
"wall",
"pyramid",
"circle",
"ring",
"disc",
"platform",
"oval",
"ellipsoid"
],
"description": "Type of 3D geometry."
},
"block": {
"type": "string",
"description": "Block material (e.g. \"stone_bricks\", \"gold_block\", \"glass\", \"white_wool\", \"wood\")."
},
"origin": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"z": {
"type": "number"
}
},
"description": "Center origin coordinate. Defaults to resting on the terrain in front of the player."
},
"width": {
"type": "number",
"description": "Width / length X (default 5)."
},
"height": {
"type": "number",
"description": "Height Y (default 4)."
},
"depth": {
"type": "number",
"description": "Depth / thickness Z (default 5)."
},
"radius": {
"type": "number",
"description": "Radius for spheres, domes, cylinders, circles (default 3)."
},
"hollow": {
"type": "boolean",
"default": false,
"description": "If true, leaves the interior empty."
},
"animated": {
"type": "boolean",
"default": false,
"description": "If true, places blocks progressively over time with audio."
},
"delayMs": {
"type": "number",
"default": 15,
"description": "Delay between block batches in milliseconds if animated is true."
}
},
"required": [
"shape",
"block"
]
}
}build_structureAction
Constructs an architectural building: "cottage" (furnished cozy wooden cottage), "castle" (medieval stone fortress with towers), "watchtower" (stone battlements tower), "pyramid" (ancient desert tomb), "fountain" (water fountain), or "portal" (nether portal).
View tool JSON
{
"name": "build_structure",
"kind": "act",
"impl": "imperative",
"description": "Constructs an architectural building: \"cottage\" (furnished cozy wooden cottage), \"castle\" (medieval stone fortress with towers), \"watchtower\" (stone battlements tower), \"pyramid\" (ancient desert tomb), \"fountain\" (water fountain), or \"portal\" (nether portal).",
"inputSchema": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"cottage",
"house",
"watchtower",
"tower",
"pyramid",
"castle",
"fortress",
"fountain",
"portal",
"nether_portal"
],
"description": "Structure type to construct."
},
"origin": {
"type": "object",
"properties": {
"x": {
"type": "number"
},
"y": {
"type": "number"
},
"z": {
"type": "number"
}
},
"description": "Optional world coordinate where to build the structure."
},
"instant": {
"type": "boolean",
"default": true,
"description": "If true, builds instantly. If false, builds progressively with construction sounds."
}
},
"required": [
"type"
]
}
}undo_last_buildAction
Reverts the most recent building or placement batch, restoring previous blocks.
View tool JSON
{
"name": "undo_last_build",
"kind": "act",
"impl": "imperative",
"description": "Reverts the most recent building or placement batch, restoring previous blocks.",
"inputSchema": {
"type": "object",
"properties": {}
}
}