Getting Started en

Getting Started

This page takes you from zero to a running AIBot and Bob's first goal.

1. Requirements

Component	Version
Minecraft	1.21.3
Fabric Loader	0.18.4+
Fabric API	0.114.1+1.21.3
Yarn Mappings	1.21.3+build.2
Java	21
Gradle	bundled Wrapper

⚠️ Versions are hard constraints. Minecraft / Fabric API method signatures change across versions — stick to the above.

2. Clone & build

git clone https://github.com/zoyluoblue/mc_aiplayer.git
cd mc_aiplayer

./gradlew build

Artifacts land in build/libs/ (aibot-<version>.jar).

3. Run the dev environment

./gradlew runServer    # dev server
./gradlew runClient    # dev client (with the Bob panel)

On first launch the mod writes aibot.json to the Fabric config dir (usually run/config/aibot.json in dev).

4. Configure the model

AIBot defaults to DeepSeek (OpenAI-compatible). Use an environment variable for the key:

export DEEPSEEK_API_KEY="sk-your-key"

Or edit aibot.json:

{
  "deepseek": {
    "apiKey": "sk-your-key",
    "baseUrl": "https://api.deepseek.com",
    "model": "deepseek-chat"
  }
}

Want a different provider? Point baseUrl at any OpenAI-compatible endpoint. Full fields in Configuration.

Without a key the log prints deepseek_key_missing and natural-language decisions are disabled (deterministic /aibot task commands still work).

5. Spawn your first bot

In-game (requires OP / command permission):

/aibot spawn Bob
/aibot list

6. Give it a goal

Option A — natural language (via the LLM):

/aibot brain say Bob mine 3 diamonds

Bob back-chains the goal into a full plan (chop wood → craft pickaxe → descend → mine iron → upgrade → staircase to the diamond layer → mine) and executes it; failed steps trigger re-planning. See Goal Engine.

Option B — deterministic task (no LLM):

/aibot task assign Bob mine minecraft:stone 16
/aibot task status Bob

Option C — client panel: press Alt + 0 to open the Client Panel and send messages or click buttons.

7. Next steps

• Available commands → Commands
• Tune perception / combat / night behavior → Configuration
• Understand how it thinks → Architecture · Goal Engine · Task System
• Hit a problem → FAQ