ModsFinder

projectBEA

by emqnuele

projectBEA opens a WebSocket bridge between Minecraft and external AI systems, so programs can read game state and send actions into the world.

FabricForgeNeoForgeClient-side onlyMIT License1.21.1 – 26.2

What it does

The bridge reads player state at intervals and sends it as JSON packets, covering health, hunger, coordinates, inventory and the blocks and entities around the player. External programs send command packets back, and the mod maps them to in-game behavior such as pathfinding, mining, crafting and combat. Status updates of IDLE, FINISHED or INTERRUPTED return to the sender, so an agent can react to outcomes and handle errors.

Screenshot requests can be made remotely, and chat and other social interaction pass through the same channel. The default address is ws://localhost:8080, and both state updates and action requests use standardized JSON envelopes. The mod is built for Python-based AI frameworks such as ProjectBEA, and it requires Fabric API on every loader. Servers do not need it; each player installs it for their own game.

Key features

  1. State broadcasting

    Player health, hunger, coordinates, inventory and nearby blocks and entities are sent out in periodic JSON packets.

  2. Action execution

    Outside programs send command packets, and the mod turns them into in-game actions such as walking a route, digging, assembling items and fighting.

  3. Asynchronous feedback

    Each action reports IDLE, FINISHED or INTERRUPTED, letting the sending program respond to results as they happen.

  4. Vision and chat channel

    Remote screenshot requests and in-game chat share the connection, giving an agent visual context and a social channel.

Compatibility

Latest build for each game version and loader.

No stable releases
Every published file is a beta or alpha build.
26.23.0.0+26.23.0.0+26.2-forge3.0.0+26.2-neoforge
26.12.1.0+26.1Not availableNot available
1.21.11.2.1Not availableNot available
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Requirements

Dependencies declared by the latest file for each loader.

Required 1

Fabric APILightweight and modular API providing common hooks and intercompatibility measures utilized by mods using the Fabric toolchain.
Required

Questions

Does projectBEA need Fabric API?

Yes. Fabric API is a required dependency, and the mod is published for Fabric, Forge and NeoForge.

Which game versions does projectBEA support?

Files cover 1.21.1, 26.1 and 26.2. The latest file for each loader is 3.0.0 for 26.2, released in beta.

Where does the WebSocket server listen by default?

The default address is ws://localhost:8080, so the external program connects to that port on the same machine.

In the catalog

projectBEA is one of 29,952 Game mechanics mods on ModsFinder, and one of 19,630 Game mechanics mods for Fabric. 13,894 mods support Minecraft 26.2.

More from emqnuele

All projects

Similar mods

What the author says

BeaCraft is a Fabric mod that functions as a WebSocket interface between Minecraft and external AI systems. It provides the necessary infrastructure for LLM-based agents to perceive the game world and execute complex tasks programmatically.
emqnuele, on the Modrinth page

Official listing

Owner
emqnuele
Published
2026-02-18
Updated on Modrinth
2026-10-14
Facts verified
2026-10-15

Tags