Getting Started

新手上路 · Getting Started

本页带你从零跑起 AIBot,并让 Bob 完成第一个目标。

1. 环境要求

组件	版本
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	随仓库 Wrapper

⚠️ 版本是硬约束。Minecraft / Fabric API 跨版本方法签名常变,务必使用以上版本。

2. 获取与构建

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

./gradlew build

构建产物在 build/libs/ 下(aibot-<version>.jar)。

3. 运行开发环境

./gradlew runServer    # 开发服务端
./gradlew runClient    # 开发客户端(含 Bob 面板)

首次启动时,Mod 会在 Fabric 配置目录写出 aibot.json(开发环境通常是 run/config/aibot.json)。

4. 配置 AI 模型

AIBot 默认走 DeepSeek(兼容 OpenAI 风格接口)。推荐用环境变量提供 Key:

export DEEPSEEK_API_KEY="sk-your-key"

也可以编辑 aibot.json:

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

想换别的提供商?把 baseUrl 指向任意 OpenAI 兼容端点即可。完整字段见 Configuration。

若没配置 Key,日志会打印 deepseek_key_missing,自然语言决策将不可用(但确定性 /aibot task 命令仍可用)。

5. 生成第一个 Bot

进入游戏后(需要 OP / 命令权限):

/aibot spawn Bob
/aibot list

6. 下达第一个目标

方式 A — 自然语言(走大模型):

/aibot brain say Bob 挖 3 颗钻石

Bob 会把目标倒推成完整计划(采木 → 做镐 → 下矿层 → 挖铁升级 → 台阶下到钻石层 → 开挖),自行执行;失败会自动重规划。原理见 Goal Engine。

方式 B — 确定性任务(不走大模型):

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

方式 C — 客户端面板: 按 Alt + 0 打开 Client Panel,直接发消息或点按钮。

7. 下一步

• 想看能下哪些命令 → Commands
• 想调感知范围 / 战斗 / 夜晚等行为 → Configuration
• 想理解它怎么思考 → Architecture · Goal Engine · Task System
• 遇到问题 → FAQ