mc_aiplayer
Autonomous AI agent that plays Minecraft on its own — a server-side Fabric mod (MC 1.21.3) where a DeepSeek / OpenAI-compatible LLM drives a real player to mine
What is mc_aiplayer?
Autonomous AI agent that plays Minecraft on its own — a server-side Fabric mod (MC 1.21.3) where a DeepSeek / OpenAI-compatible LLM drives a real player to mine, build, farm, fight and survive from natural-language commands. LLM plans, deterministic tasks execute — no Python harness, no bot account.
Overview of mc_aiplayer
What it is
mc_aiplayer (also referred to as AIBot in its README) is an open-source server-side Fabric mod for Minecraft 1.21.3. It creates a real server-side player that accepts natural-language instructions and maps them onto deterministic game logic for mining, crafting, smelting, building, farming, combat, fishing, trading, storage, and survival. The LLM (DeepSeek or any OpenAI-compatible model) plans the intent, while 34 concrete Task state machines and 63 tools execute the actions. No Python harness or bot account is required.
Key features
- 63 tools and 34 deterministic Task state machines for execution - 9 typed Goal variants covering item acquisition, pickaxe tiers, ore, crops, armor, workstations, stockpiles, food, and blueprint builds - Two operating profiles:
strict_survival(default) andoperator - Runtime control with cancel/replace and nested pause/resume - Versioned atomic snapshot for state persistence across restarts - Authorization checks for commands, panel actions, chat routing, and shared jobs - Supports DeepSeek and any OpenAI-compatible chat/tool-calling endpoint
Use cases
Automate resource gathering (mining, farming, fishing), crafting and smelting, building structures, combat and survival tasks, trading with villagers, managing storage, and executing complex multi-step goals from natural-language commands.
Getting started
bash git clone https://github.com/zoyluoblue/mc_aiplayer.git cd mc_aiplayer ./gradlew build ./gradlew runServer ./gradlew runClient export DEEPSEEK_API_KEY='sk-your-key' For full configuration details, see the repository README.
License and pricing
Licensed under MIT. Open source (no pricing).
Based on the project's public README and repository metadata.