Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| host | No | Minecraft server host | localhost |
| port | No | Minecraft server port | 25565 |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| joinGame | Spawn a bot into the Minecraft game |
| leaveGame | Disconnect a bot from the game |
| attackSomeone | Attack, kill, defend against, or initiate combat with someone |
| cookItem | Cook an item in a furnace |
| craftItems | Craft items using a crafting table or inventory |
| dance | Make the bot dance by moving and jumping |
| dropItem | Drop items from inventory |
| eatFood | Eat food from inventory to restore hunger |
| equipItem | Equip an item (armor, tool, or weapon) |
| giveItemToSomeone | Give items to another player |
| goToKnownLocation | Navigate to specific coordinates |
| goToSomeone | Navigate to another player |
| harvestMatureCrops | Harvest mature crops from nearby farmland |
| hunt | Hunt animals or mobs |
| mineResource | Mine specific blocks or resources |
| openInventory | Open the bot's inventory |
| openNearbyChest | Open a nearby chest |
| pickupItem | Pick up items from the ground |
| placeItemNearYou | Place a block or item near the bot |
| prepareLandForFarming | Prepare land for farming by tilling soil |
| rest | Rest to regain health |
| retrieveItemsFromNearbyFurnace | Retrieve smelted items from a nearby furnace |
| runAway | Run away from a threat |
| sleepInNearbyBed | Find and sleep in a nearby bed |
| smeltItem | Smelt items in a furnace |
| swimToLand | Swim to the nearest land when in water |
| useItemOnBlockOrEntity | Use an item on a block or entity |
| lookAround | Look around and observe the environment, providing a detailed text-based view of surroundings |
| buildSomething | Build structures using Minecraft commands (requires cheats/operator permissions). Supports two modes: 1) buildScript - array of command objects like [{"command": "fill", "x1": 0, "y1": 64, "z1": 0, "x2": 10, "y2": 70, "z2": 10, "block": "stone"}], 2) code - JavaScript string for dynamic building like "for(let i = 0; i < 10; i++) { setBlock(pos.x + i, pos.y, pos.z, 'stone'); }" |
| buildPixelArt | Build pixel art from an image in Minecraft (requires cheats/operator permissions). Converts an image to pixel art using colored blocks. Maximum size is 256x256 blocks. |
| readChat | Read recent chat messages from the server. Returns player messages, system messages, whispers, action bar messages, and titles. |
| sendChat | Send chat messages or commands to the server. Can send regular messages, commands (starting with /), or whispers. |