Find blocks, biomes, or structures
locateFind the nearest Minecraft blocks, biomes, or structures by target and radius, searching around coordinates, a player, or world spawn.
Instructions
The nearest blocks, biomes, or structures of some kinds, nearest first. block takes keys or tags (minecraft:diamond_ore, #minecraft:logs, #minecraft:iron_ores) and reads only loaded chunks (those near players), 32 blocks around by default; unloadedChunks says how many in range it skipped. biome asks the world generator, so it reaches unexplored land, 1024 blocks around by default. structure takes keys such as stronghold, ancient_city, trial_chambers, or a prefix such as village that matches every village kind; radius is in chunks, and unexplored keeps only ones nobody found yet. Without x and z it searches around the player (the user's own when WORLDAPI_PLAYER is set), or, for biomes and structures, from the world spawn. Coordinates are private: it needs players:private, or anonymous access the server allows. Structure search blocks the server thread for a moment, so keep the radius modest.
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": {
"kind": "<kind>",
"targets": "<targets>"
},
"name": "locate"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | No | Block X of the center | |
| y | No | Needed for blocks when x and z are given | |
| z | No | Block Z of the center | |
| kind | Yes | What targets name | |
| limit | No | Results to return, nearest first; 10 by default | |
| world | No | World name; the player's world, or `world`, when left out | |
| player | No | Search around this player instead of x, y, z | |
| radius | No | Blocks for blocks and biomes, chunks for structures | |
| targets | Yes | Such as ["minecraft:diamond_ore", "#minecraft:logs"], ["minecraft:cherry_grove"], or ["village"] | |
| unexplored | No | Structures only: only ones nobody has found yet |