PlayerEngine

# PlayerEngine: The AI Embodiment Framework for Minecraft (https://img.shields.io/badge/Player2-AI_Game_Jam-blueviolet)](https://itch.io/jam/ai-npc-jam) (https://img.shields.io/badge/Powered%20by-Automatone-orange)](https://github.com/Ladysnake/Automatone/tree/1.20) (https://img.shields.io/badge/Based%20on-ChatClef-9cf)](https://github.com/elefant-ai/chatclef/tree/main) **PlayerEngine** is a server-side framework designed to fundamentally change how AI NPCs exist in Minecraft. Developed by **Goodbird**, this project moves beyond the limitations of client-side mods, offering a powerful toolkit to give **your own custom mobs** the full capabilities of a player. This project was born from the desire to transcend the gimmick of chatbot NPCs and create truly embodied agents for the **Player2 AI Game Jam**. It's not about making vanilla pigs talk; it's about empowering developers to create entities that can mine, fight, manage an inventory, and interact with the world on a player's level. ## The Story: From Client-Side Hacks to a True Framework The inspiration for PlayerEngine came from **ChatClef**, an innovative mod by Player2 that connected an AI to the player's client. While groundbreaking, it had a significant limitation: to have AI companions, one had to run multiple instances of the Minecraft client. This was cumbersome and not scalable. PlayerEngine solves this problem by moving the logic to the server and, most importantly, decoupling player-like abilities from the `PlayerEntity` class itself. The result is a true framework that allows any modder to grant their custom `LivingEntity` the soul of a player. ## The Core Concept: The "Player" as an Interface At its heart, PlayerEngine treats "being a player" not as a specific entity type, but as a set of capabilities that can be attached to any mob. By implementing a few simple interfaces, your custom mob gains access to: * A persistent, player-like inventory (`LivingEntityInventory`). * The ability to interact with the world, breaking blocks and using items (`LivingEntityInteractionManager`). * Advanced pathfinding and task execution via the powerful **Automatone** engine. This makes PlayerEngine the ultimate "actuator" layer for an AI "brain" like the one provided by the **Player2 API**. Your LLM can decide *what* to do, and PlayerEngine gives your NPC the body to *do it*. ## Key Features for Developers * **🤖 Empower Your Mobs:** Designed for modders. Easily transform your own custom entities into player-like agents. Don't just reskin a vanilla mob—give your unique creations true agency. * **⛏️ True World Interaction:** NPCs can mine blocks, use tools, and interact with objects. *(Note: complex building is not yet supported).* * **🎒 Player-Like Inventories:** Each agent manages its own persistent inventory, allowing for complex resource gathering, crafting, and tool management. * **🧠 Seamless Player2 Integration:** PlayerEngine is the perfect physical counterpart to the Player2 API. Send high-level commands like `@get diamond 5` and watch your agent execute a complex chain of tasks to achieve the goal. * **🛠️ Built on a Solid Foundation:** * **Navigation:** Powered by **Automatone**, a fork of the legendary Baritone pathfinding engine. * **Task System:** Adapts the robust task and command system from Player2's **ChatClef**. * **Modularity:** Uses **Cardinal Components** to cleanly attach capabilities, ensuring high compatibility and easy integration. ## Why PlayerEngine is "Beyond an AI Gimmick" * **Integration:** It's a framework for deep systemic integration. NPCs are no longer just quest-givers; they are active participants in the game's economy, ecology, and emergent stories. * **Guardrails:** PlayerEngine *is* the guardrail. It provides a deterministic, game-logic-based action layer that reliably executes the high-level goals from an LLM, complete with fallbacks and a robust understanding of the game world. * **Creativity:** It empowers *other creators*. We're not just showing one cool NPC; we're giving the entire community a tool to build their own intelligent companions, adversaries, and dynamic storytellers. * **Stability:** Built on the shoulders of giants—Baritone and Cardinal Components—PlayerEngine is a stable and performant foundation for ambitious AI projects. ## Acknowledgements This project stands on the work and support of many. ### Player2 This framework was created for the **Player2 AI Game Jam** and is designed to integrate seamlessly with the Player2 API, realizing their vision for intelligent, interactive agents. > *We are a team of researchers and engineers that are passionate about advancing the state of the art in AI. Our team members have worked at some of the world's leading tech companies and research institutions, and we are united by our shared vision of building intelligent agents that can interac