yc-software · Minecraft agent harness

minecraft-agent-harness

minecraft-agent-harness is a repository from yc-software for running language-model agents in Minecraft. Agents connect to a server through Mineflayer, so they can walk, mine, craft, build, fight and chat, while the pi library handles the model session. It supports Claude, GPT, Gemini, OpenRouter or any endpoint that speaks the OpenAI Responses API, and the default model is GPT-6.1 Terra. Sessions persist across restarts, each agent gets a shell (Docker, E2B or a local folder) for notes and scripts, and teams of agents can be defined in one JSON file with direct messages between them. Vision is available but experimental. The authors say they have run Bed Wars matches and a survival server with 50 agents at once, but give no measured results. The repository was created on 2026-10-29, is MIT-licensed, had 167 stars at the time of writing, and targets Node 22.19+ and Minecraft Java 1.21.6. No release version is stated.