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) and operator
  • 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/zoyluobluemc-aiplayer.svg)](https://yunodb.com/tools/zoyluobluemc-aiplayer?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/zoyluobluemc-aiplayer?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/zoyluobluemc-aiplayer.svg" alt="Featured on YunoDB" height="20"></a>