Workling: Agents

Client-only Workling add-on that lets an AI agent play multiplayer Minecraft with few tokens: compact JSON state and simple commands on a local bridge.
item image

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 port 25590), refuses browser requests (Origin) and non-local Host; commands only by POST.
  • Token-friendly reads: /state with since returns only what changed; /events is a long-poll that sleeps until something happens (imp=1 only for important events, only=chat,die,hp,food to 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: /craft uses the recipe book (only unlocked recipes), in the 2x2 inventory grid or at the nearest crafting table.
  • Tree chopping: /chop cuts 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: /stats counts 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.toml or 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 port 25590), refuses browser requests (Origin) and non-local Host; commands only by POST.
  • Token-friendly reads: /state with since returns only what changed; /events is a long-poll that sleeps until something happens (imp=1 only for important events, only=chat,die,hp,food to 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: /craft uses the recipe book (only unlocked recipes), in the 2x2 inventory grid or at the nearest crafting table.
  • Tree chopping: /chop cuts 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: /stats counts 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.toml or in the mod's config screen

Workling: Agents Team

profile avatar
Owner
  • 3
    Projects
  • 192
    Downloads
Donate

More from lvpaes

  • Workling: Moreblocks project image

    Workling: Moreblocks

    Workling add-on with 303 decorative blocks: stone variants, copper shingles and tiles, and rose quartz, with their original textures and recipes.

    • 38
    • November 19, 2026
  • Workling project image

    Workling

    Workling traz novas formas de fazer as coisas em Minecraft, combinando mecânicas úteis, novas possibilidades e pequenos ajudantes para o seu mundo.

    • 146
    • November 13, 2026
  • Workling: Moreblocks project image

    Workling: Moreblocks

    Workling add-on with 303 decorative blocks: stone variants, copper shingles and tiles, and rose quartz, with their original textures and recipes.

    • 38
    • November 19, 2026
  • Workling project image

    Workling

    Workling traz novas formas de fazer as coisas em Minecraft, combinando mecânicas úteis, novas possibilidades e pequenos ajudantes para o seu mundo.

    • 146
    • November 13, 2026