qxfMCAI v12 · 智慧快行

面向 Minecraft Java 1.20.1 / Forge 的全中文 AI 毛毛龙生存伙伴。龙龙始终称绑定玩家为“主人”，能理解现场、产生喜怒哀乐、聊天互动、跟随与骑乘，并把 AI 规划落实为真实移动、挖矿、建造、耕作、战斗和工具使用。

v12 重点

• 针对 Forge 47.4.0 编译并声明最低版本 47.4.0；客户端与服务端都需安装同一 JAR。

• “停止、暂停、继续、跟随、过来”直接在服务端执行；取消后旧 API 回复失效，不会把已取消任务重新排队。

• 主控制台显示真实当前任务、进度、待办队列、上次结果和 API 状态；设置与提示词编辑仍在同一菜单内。

• 挖矿和找矿洞采用跨帧游标搜索，每轮限制扫描数量，避免重复扫描浅层或一次卡住服务器。

• API 请求可取消、设置超时，最多并发四人；服务端重启和玩家离线时清理待处理请求与聊天历史。

• 普通提问和五分钟聊天只回复，不执行 AI 幻觉动作；明确交付任务由 API 规划，空闲自主决策最多启动一项非建造行动。游戏命令要求主人自身具有 OP4。

• 暂停保留本次运行中的任务进度；重开存档后，未完成的现场任务需重新交付，已有建筑与物资会保留。

• 修复跟随和骑乘：召唤/召回默认恢复跟随，主人可直接操纵龙龙移动，潜行下马

• 新增显示/隐藏和“一键无敌/普通生存”控制；隐藏不会停止思考或已接受任务

• 新增可放在任意方块上的四合一实体棋桌；五子棋、中国象棋、13×13 围棋和四人麻将均在独立界面操作，不再刷聊天框

• 麻将使用136张牌，支持吃、碰、明杠、暗杠、胡、自摸、过、七对与十三幺；主人对战龙龙和两名AI

• 喜怒哀乐会响应主人说的话、主人攻击、骑乘、隐藏、棋盘放拆及龙龙储物空间的取放，并进入长期记忆

• AI 请求会读取生物群系、昼夜、天气、光照、脚下与视线方块、附近敌怪/动物/掉落物，用当前场景组织对话

• 无需 /mcai ask：聊天输入 U：你好 即可，玩家显示为 U，龙龙回应显示为 AI·龙龙：

• DeepSeek 设置提供官方 deepseek-v4-pro 与 deepseek-v4-flash 快速切换

• 动作加入跨姿态平滑过渡；继续使用标准 64×64 二维皮肤与原版玩家骨骼，保持轻量

• 控制台提供“传送到 qxf1975”：其他玩家点击后将自己传送至在线玩家 qxf1975，不移动目标玩家

“意识、想法和长期记忆”是游戏角色模拟。家庭玩法不含露骨内容，关系推进需要主人明确同意。

安装

1. 安装 Minecraft 1.20.1 与 Forge 47.4.0 或更高版本。
2. 下载 qxfmcai-12.0.0.jar，放入客户端与服务端的 mods 文件夹，并移除旧版 qxfMCAI JAR。
3. 不需要 Yes Steve Model 或 Touhou Little Maid；v11 不会改动主人的玩家皮肤。
4. 进入世界后按 M 打开紧凑控制台，配置 OpenAI、DeepSeek 或兼容 OpenAI Chat Completions 的接口。

使用

控制台最上方可直接输入自然语言，也可输入以 / 开头的命令。普通聊天还可直接在聊天框加 U： 前缀。示例：

带上镐子向下寻找铁矿，找到矿洞后告诉主人
设计一座集中在基地旁的小仓库并真正建起来
U：龙龙，你觉得这里适合安家吗？
/mcai play dance
/mcai board

常用命令：

• /mcai summon：召唤龙龙
• /mcai pause、/mcai resume、/mcai stop：立即暂停、继续或取消任务；菜单里也有对应按钮
• /mcai status：查看任务、好感度、存储和棋类战绩
• /mcai inventory：打开 27 格物资背包
• /mcai ride：骑乘并直接操纵龙龙
• /mcai hide [true|false]：隐藏或显示龙龙
• /mcai board：领取可放置的五子棋/象棋/围棋/麻将四合一棋桌
• /mcai play [动作]：在主人面前表演；支持 wave/dance/cheer/bow/shy/stretch/nod/look/spin/hop
• /mcai invincible [true|false]：OP4 一键切换无敌与普通生存
• /mcai special teleport_to_qxf1975：操作者本人传送到在线的 qxf1975；无需 OP，不会移动目标玩家
• /mcai command <命令>：执行主人明确授权的 OP4 命令任务

AI 与安全

API 密钥保存在 Forge 服务端配置中，不通过聊天回传。也可使用环境变量 OPENAI_API_KEY、DEEPSEEK_API_KEY 或 QXF_MCAI_API_KEY。

网络失败时，本地规划器会保底执行已明确交付的生存任务。五分钟聊天通道强制为空动作，不会自动建造、挖矿、战斗或执行命令。普通玩家无法通过龙龙借用 OP4 权限；只有玩家自身具备 OP4 且服务端启用命令时，明确下达的命令才会执行。世界修改仍受边界、方块实体、流体和任务队列限制。

构建

需要 JDK 17：

./gradlew clean build --no-daemon

输出：build/libs/qxfmcai-12.0.0.jar。