Typed Minecraft actions for LLM agents.
Every action the LLM can emit is a pydantic model with a kind discriminator.
The full union (MinecraftAction) is passed to LLMBrain as action_types so
the model's choice arrives already validated — no JSON parsing, no regex.
Categories
- Movement : Move, Jump, Sneak, Sprint, LookAt
- World : MineBlock, PlaceBlock, UseItem, ActivateBlock
- Inventory : EquipItem, DropItem, Craft
- Social : Chat, Whisper
- Navigation: NavigateTo (Mineflayer pathfinder handles the pathfinding)
- Meta : Wait, NoOp
Bases: Action
Walk one step in a cardinal direction.
Bases: Action
Jump (optionally while moving).
Bases: Action
Toggle sneaking on or off.
Bases: Action
Turn to face a target — block coordinates or entity name.
Bases: Action
Dig/break a block at a given position (or the block the bot is looking at).
Bases: Action
Place a block from inventory at a given position.
Bases: Action
Right-click / use the currently equipped item (optionally on a target block).
Bases: Action
Right-click a block to open/use it (chest, furnace, door, lever, etc.).
Bases: Action
Move an item to the bot's hand or armour slot.
Bases: Action
Drop one or more of an item from inventory.
Bases: Action
Craft an item by name (recipe looked up on the bot side).
Bases: Action
Send a public message in Minecraft chat.
Bases: Action
Send a private /msg to another player.
Bases: Action
High-level pathfind to a position. Mineflayer pathfinder handles obstacles.
Bases: Action
Follow a named player or mob until the next action.
Bases: Action
Do nothing for a number of ticks. Useful when waiting for events.