Description
Workling: Agents is a client-only add-on for Workling that lets an AI agent (an LLM) play multiplayer Minecraft while spending as few tokens as possible. The mod exposes the game state as compact JSON on a local HTTP bridge and follows simple commands: the agent reads what changed, decides, and sends one short order. Walking, following, eating, sleeping and running away from danger are handled inside the mod, so the agent only wakes up when something important happens.
Highlights
- Client only: no blocks, items, entities or network payloads. It joins servers that don't have the mod installed.
- Local bridge: listens only on
127.0.0.1(default port25590), refuses browser requests (Origin) and non-localHost; commands only byPOST. - Token-friendly reads:
/statewithsincereturns only what changed;/eventsis a long-poll that sleeps until something happens (imp=1only for important events,only=chat,die,hp,foodto filter). - Compact views of the world: nearby mobs and players with relative position and direction, a top-down character map of the terrain around you, chat history with mentions.
- Own pathfinding: walks to a point or follows a player, jumps 1-block gaps, sprints on long paths, opens wooden doors (never breaks them).
- Chests: deposit/take items from the agent's chests (a chest with a wall sign carrying its name), chests remembered by name, or a chest at a given position; read a chest's contents; real moved counts in every answer.
- Workling golem chests: lists Workling golem chests and uses only their Chest tab (what the golem stores), never the golem's own items or tools.
- Crafting:
/craftuses the recipe book (only unlocked recipes), in the 2x2 inventory grid or at the nearest crafting table. - Tree chopping:
/chopcuts a whole natural tree with the best axe in the inventory, using normal vanilla breaking. A classifier tells trees from buildings: logs touching planks, glass, doors, persistent leaves and other building blocks are never touched. Tree logs are the only blocks the agent ever breaks. - Macros: save a list of steps (goto, follow, take, deposit, shelter, chop, say, wait…) and run it by name.
- Token meter:
/statscounts requests and bytes per route and estimates tokens (bytes / 4).
Built-in routines
These run inside the mod and cost no tokens:
- Chat: only players in the priority list become events; everyone else stays in the chat history.
- Danger: stops for a hostile mob in sight and resumes the walk/follow 3 s after the danger is gone.
- Food and health: eats by itself when hungry. With no food it takes bread from its chests, or wheat from the chest named
food, crafts bread at the nearest table, eats and stores the rest. If nothing works it asks in chat. With low health near a hostile it flees to its shelter or away. - Sleep: when other players sleep, goes to a free bed nearby (or places the bed it carries); inside the base it sleeps in the base bed.
- Emotes and idle: crouches back at a priority player who crouches, does small idle behaviors (look at players, look around, crouch, hop) and raises an idle event after a while.
- Memory: base, bed, shelter and named chests are saved per dimension.
Commands
Reads (GET): /state, /events, /mobs, /players, /terrain, /chat, /chests, /chest, /stats.
Commands (POST): /goto, /follow, /look, /jump, /attack, /use, /eat, /slot, /stop, /say, /crouch, /hop, /prio, /deposit, /take, /shelter, /base, /bed, /chest, /craft, /chop, /macro.
Requirements
- Minecraft 26.3, NeoForge 26.3.0.77+
- Workling 0.2.24+ (required)
- Installed on the client only
- Languages: English and Brazilian Portuguese
- Settings in
config/workling_agents-client.tomlor in the mod's config screen only** add-on for Workling that lets an AI agent (an LLM) play multiplayer Minecraft while spending as few tokens as possible. The mod exposes the game state as compact JSON on a local HTTP bridge and follows simple commands: the agent reads what changed, decides, and sends one short order. Walking, following, eating, sleeping and running away from danger are handled inside the mod, so the agent only wakes up when something important happens.
Highlights
- Client only: no blocks, items, entities or network payloads. It joins servers that don't have the mod installed.
- Local bridge: listens only on
127.0.0.1(default port25590), refuses browser requests (Origin) and non-localHost; commands only byPOST. - Token-friendly reads:
/statewithsincereturns only what changed;/eventsis a long-poll that sleeps until something happens (imp=1only for important events,only=chat,die,hp,foodto filter). - Compact views of the world: nearby mobs and players with relative position and direction, a top-down character map of the terrain around you, chat history with mentions.
- Own pathfinding: walks to a point or follows a player, jumps 1-block gaps, sprints on long paths, opens wooden doors (never breaks them).
- Chests: deposit/take items from the agent's chests (a chest with a wall sign carrying its name), chests remembered by name, or a chest at a given position; read a chest's contents; real moved counts in every answer.
- Workling golem chests: lists Workling golem chests and uses only their Chest tab (what the golem stores), never the golem's own items or tools.
- Crafting:
/craftuses the recipe book (only unlocked recipes), in the 2x2 inventory grid or at the nearest crafting table. - Tree chopping:
/chopcuts a whole natural tree with the best axe in the inventory, using normal vanilla breaking. A classifier tells trees from buildings: logs touching planks, glass, doors, persistent leaves and other building blocks are never touched. Tree logs are the only blocks the agent ever breaks. - Macros: save a list of steps (goto, follow, take, deposit, shelter, chop, say, wait…) and run it by name.
- Token meter:
/statscounts requests and bytes per route and estimates tokens (bytes / 4).
Built-in routines
These run inside the mod and cost no tokens:
- Chat: only players in the priority list become events; everyone else stays in the chat history.
- Danger: stops for a hostile mob in sight and resumes the walk/follow 3 s after the danger is gone.
- Food and health: eats by itself when hungry. With no food it takes bread from its chests, or wheat from the chest named
food, crafts bread at the nearest table, eats and stores the rest. If nothing works it asks in chat. With low health near a hostile it flees to its shelter or away. - Sleep: when other players sleep, goes to a free bed nearby (or places the bed it carries); inside the base it sleeps in the base bed.
- Emotes and idle: crouches back at a priority player who crouches, does small idle behaviors (look at players, look around, crouch, hop) and raises an idle event after a while.
- Memory: base, bed, shelter and named chests are saved per dimension.
Commands
Reads (GET): /state, /events, /mobs, /players, /terrain, /chat, /chests, /chest, /stats.
Commands (POST): /goto, /follow, /look, /jump, /attack, /use, /eat, /slot, /stop, /say, /crouch, /hop, /prio, /deposit, /take, /shelter, /base, /bed, /chest, /craft, /chop, /macro.
Requirements
- Minecraft 26.3, NeoForge 26.3.0.77+
- Workling 0.2.24+ (required)
- Installed on the client only
- Languages: English and Brazilian Portuguese
- Settings in
config/workling_agents-client.tomlor in the mod's config screen
