SYSTEM ARCHITECTURE

AIBot — 自主 Minecraft AI 玩家

大语言模型理解意图 · 确定性引擎可靠执行 · 五层安全网兜底求生
164Java 类
30K行代码
62大脑工具
36任务状态机
9目标类型
5层安全网
🎮

接入层 · 你怎么指挥它

command · network
命令行 + 客户端面板 + 大白话,三种方式下达目标
/aibot 命令 · spawn/task/brain Bob 客户端面板 · Alt+O 自然语言指令
指令进入世界中的 bot
🌍

Minecraft 世界

Fabric 1.21.3 · Java 21
方块 / 实体 / 物品 / 光照 / 流体——bot 感知与行动的环境
感知 perception · observe
🧠

大脑层 · 理解意图

brain (15)
DeepSeek 大模型工具调用循环——把自然语言指令翻译成目标与动作
BrainCoordinator ActionDispatcher · 派发+拦截 ToolRegistry · 62 工具 DeepSeek LLM
意图 → 声明式目标
🎯

目标引擎 · 倒推规划

goal (4)
说一句「挖 3 颗钻石」→ 自动倒推出几十步完整计划,无需人教
Goal · 声明式目标 GoalPlanner · 反向链 ensureItem GoalExecutor · 状态机
目标 → 步骤 → 任务
⚙️

任务层 · 自包含状态机

task (51)
每个任务独立闭环、自带看门狗;互不嵌套,失败可被上层重规划
OreDig 找矿DescendToY 下矿层 DigDown 台阶下挖Gather 采集 Smelt 熔炼Craft 合成 Hunt 狩猎Combat 战斗 Move 寻路Build 建造 Farm 种田Fish 钓鱼 Trade 交易Breed 养殖 Sleep 睡觉… +29
调用共享原语
🛠️

共享原语

action (20)
BlockMinerDigNav ActionPackHarvestCore WalkToController
🧭

寻路

pathfinding (11)
A* PathfinderStandability NeighborEnumeratorPathExecutor
📚

领域知识

craft · mining (10)
RecipeRegistryMiningChain SmeltChainToolTier OreScanOreProspector 探矿
作用于实体
🤖

AIPlayerEntity · 服务端假玩家

entity
继承 ServerPlayerEntity,无需客户端;走路、挖掘、战斗、交互皆服务端驱动
🛡️

每 tick 安全网流水线 · 会自保

BotTickCoordinator
每游戏刻顺序执行五道关卡,任一关接管即短路本刻——绝不轻易送命
01
NavSafetyNet溺水上浮 · 岩浆逃离 · 窒息钻出
02
StuckWatcher卡死监测 · 自愈兜底
03
DangerWatcher威胁判定 · 战斗/逃跑 · 困死撤离
04
GoalExecutor推进当前目标 · 失败重规划
05
IdleCoordinator无事可做时自主生活
🌐 network 同步 💾 persist 存档 🧩 memory 记忆 🔩 mixin 注入 ⌨️ command 指令 📊 log 诊断日志 🔬 observe · verify / deplint / replay / profile ⚡ TpsGuard 性能护栏
理解(LLM) 决策(规划) 执行(任务) 原语/知识 安全网