BeaCraft: Technical Bridge for Autonomous Agents
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.
Core Functionalities
- State Broadcasting: Periodically transmits JSON packets containing player health, hunger, coordinates, inventory, and surrounding block/entity data.
- Action Execution: Maps external command packets to in-game behaviors including pathfinding, mining, crafting, and combat.
- Asynchronous Feedback: Returns status updates (IDLE, FINISHED, INTERRUPTED) to the agent, allowing for reactive logic and error handling.
- Vision & Communication: Supports remote screenshot requests for visual context processing and bridges the in-game chat for social interaction.
Technical Architecture
- Protocol: WebSocket (default
ws://localhost:8080). - Format: Standardized JSON envelopes for both state updates and action requests.
- Compatibility: Specifically designed for integration with Python-based AI frameworks like ProjectBEA.
Implementation Requirements
- Loader: Fabric Loader.
- Configuration: Managed via
config.jsonto define server ports and update frequencies. - Environment: Operates as a local bridge, requiring the external agent to run on a reachable network address.
