AI Command
使用自然语言控制 Minecraft。输入 /ai give me a maxed-out diamond sword,AI 会自动生成并执行相应的命令。
功能
/ai <text>— 描述你想要的效果,AI 会生成并执行 Minecraft 命令- 危险检测 — 破坏性命令(如 ban、kill、fill、explosives)会提示确认
- 支持多种后端 — 本地规则引擎(免费、离线)+ 9 家云提供商
- 集成 ModMenu 以提供图形化配置界面
- 命令修正器 — 自动修复能力较弱的模型产生的旧版语法错误
安装
- 安装 Fabric Loader 0.18.5 或更高版本
- 安装 Fabric API
- 将
ai-command-1.0.0.jar放入.minecraft/mods/目录 - (推荐)安装 ModMenu 以获得配置 GUI
需要 Minecraft 26.1 和 Java 25+。
使用方法
/ai give me 64 diamonds
/ai switch to creative mode
/ai give me a maxed-out netherite sword
/ai spawn a zombie named Bob
安全命令会立即执行。危险命令会要求你点击 [Confirm] 进行确认。
所有配置均可通过命令完成:
/ai-config # 显示当前配置
/ai-config provider deepseek # 切换后端
/ai-config apikey sk-xxx # 设置 API 密钥
/ai-config model deepseek-chat # 更改模型
/ai-config test # 测试连接
或者打开 ModMenu,点击 "AI Command",使用图形界面进行配置。
配置
AI 后端
| ID | Name | Type | Needs Key |
|---|---|---|---|
rule_engine |
Local Rule Engine | Offline | No |
deepseek |
DeepSeek (recommended) | Cloud | Yes |
claude |
Claude | Cloud | Yes |
openai |
OpenAI | Cloud | Yes |
qwen |
Qwen | Cloud | Yes |
glm |
GLM | Cloud | Yes |
moonshot |
Moonshot | Cloud | Yes |
ollama |
Ollama | Local | No |
custom |
Custom API | Self-hosted | Optional |
危险命令类别
| Category | Examples |
|---|---|
| Irreversible | /ban, /kill, /stop, /clear |
| Explosives | /summon tnt, /give end_crystal |
| Hostile spawns | /summon creeper, /summon wither |
| Destructive | /fill, /clone, /setblock |
| Major impact | /gamerule, /difficulty |
可通过 /ai-config danger add|remove 进行自定义。
模型推荐
DeepSeek Chat 经过最多测试,并且最能很好地处理 MC 26.1 的新语法。
Flash 变体价格更便宜,但偶尔会输出旧版语法——内置的 CommandCorrector 会自动清理这些问题,因此实际差异微乎其微。如果 Flash 在处理复杂请求时失败,请切换至 deepseek-v4-pro,其指令遵循能力会有显著提升。
Claude、GPT-4o、Qwen 及其他模型尚未经过全面测试。理论上,任何兼容 OpenAI API 的服务均可使用。
无法保证指令 100% 正确。 Minecraft 的命令系统存在诸多边缘情况。请在问题追踪器上报错,并附上日志片段(执行 /ai-config log true 以启用日志记录)。
开发过程
基于 Claude Code 构建。具体流程包括:
从 MC 26.1 源码中提取命令注册表、NBT 标签名称及实体属性,并与 zh.minecraft.wiki 进行交叉比对,历经多轮迭代优化提示词工程。旧版语法、NBT 大小写敏感性以及属性命名是反复出现的痛点。DeepSeek Flash 拒绝遵循细粒度指令是最难解决的问题——最终通过提示词优化结合后处理修正器得以解决。
项目结构
src/main/java/com/realikun/aicommand/
├── AICommandMod.java # 入口点
├── ai/
│ ├── AIProvider.java # 后端接口
│ ├── AIProviderRegistry.java # 9 个提供商
│ ├── AIRequestBuilder.java # 系统提示词
│ ├── RuleEngineProvider.java # 本地规则引擎
│ ├── LLMApiProvider.java # 云端 API 调用
│ └── CommandCorrector.java # 语法修正
├── command/
│ ├── AICommand.java # /ai
│ └── AIConfigCommand.java # /ai-config
├── config/
│ ├── AIConfig.java # 配置管理
│ └── ModMenuIntegration.java # ModMenu UI
├── safety/
│ └── CommandSafetyChecker.java # 危险检测
├── reference/
│ └── MinecraftCommands.java # MC 26.1 命令参考
└── mixin/
└── ChatLengthMixin.java # 移除聊天长度限制
许可证
CC0-1.0 — 公共领域。
作者
REALIKUN2024
发现 Bug?有建议?GitHub Issues
AI指令 (AI Command)
在聊天框中通过自然语言控制 Minecraft。输入 /ai 给我一把满级钻石剑,AI 将为你生成指令并执行。
功能概览
/ai <文本>— 用自然语言描述需求,AI 自动生成 Minecraft 指令- 危险指令检测 — 对 ban、kill、fill、爆炸物等指令弹出确认框,点击一次即可确认
- 多后端支持 — 本地规则引擎(离线免费)+ 9 个云端 AI,通过
/ai-config一键切换 - ModMenu 图形化配置界面
- 指令修正器 — 自动修复部分模型输出的旧版 MC 语法
安装
- 安装 Fabric Loader 0.18.5+
- 安装 Fabric API
- 将
ai-command-1.0.0.jar放入.minecraft/mods/目录 - 推荐安装 ModMenu 以获取图形化配置界面
需要 Minecraft 26.1,Java 25+。
使用方法
/ai 给我64个钻石
/ai 切换到创造模式
/ai 给我一把满级下界合金剑
/ai 生成一只叫小明的僵尸
AI 会返回生成的指令。安全指令直接执行,危险指令需要点击 [确认]。
所有配置均通过命令完成:
/ai-config # 查看当前配置
/ai-config provider deepseek # 切换到 DeepSeek
/ai-config apikey sk-xxx # 设置 API Key
/ai-config model deepseek-chat # 更换模型
/ai-config test # 测试连接
如果安装了 ModMenu,可以在模组列表中找到并点击 “AI指令” 进入图形界面。
配置详解
AI 后端
| 后端 | 名称 | 类型 | 需要 Key |
|---|---|---|---|
rule_engine |
本地规则引擎 | 离线 | 否 |
deepseek |
DeepSeek(推荐) | 云端 | 是 |
claude |
Claude | 云端 | 是 |
openai |
OpenAI | 云端 | 是 |
qwen |
通义千问 | 云端 | 是 |
glm |
智谱 GLM | 云端 | 是 |
moonshot |
月之暗面 | 云端 | 是 |
ollama |
Ollama | 本地 | 否 |
custom |
自定义 API | 自建 | 可选 |
危险指令分类
以下五类指令会弹出确认窗口:
| 分类 | 示例 |
|---|---|
| 不可逆 | /ban, /kill, /stop, /clear |
| 爆炸物 | /summon tnt, /give end_crystal |
| 危险召唤 | /summon creeper, /summon wither |
| 可能破坏 | /fill, /clone, /setblock |
| 重大影响 | /gamerule, /difficulty |
使用 /ai-config danger add|remove 可添加或删除自定义规则。
关于模型
经过这段时间的测试,DeepSeek Chat 在指令遵循和 MC 26.1 新版语法上表现最稳定。
Flash 版价格更便宜,但偶尔会出现旧版语法问题——模组中自带的 CommandCorrector 会自动进行修正,因此日常使用差异不大。如果遇到 Flash 版本出现严重错误,可以切换至 deepseek-v4-pro,其指令遵循能力会有显著提升。
Claude、GPT-4o、通义千问等模型未经过正式全面测试。理论上,所有兼容 OpenAI 接口的模型均可接入使用。
AI 生成的指令不保证 100% 正确。Minecraft 指令系统非常复杂,偶尔出现格式错误或参数填写不当属于正常现象。如遇 Bug,请提交 Issue,同时执行 /ai-config log true 开启日志功能,并将相关日志片段粘贴过来。
开发
本项目在 Claude Code 的辅助下完成开发。大致流程如下:
从 MC 26.1 源码中提取命令注册表、NBT 标签名及实体属性,并与 zh.minecraft.wiki 逐条交叉验证。提示词经过多轮反复修改——旧版语法残留、NBT 大小写问题以及属性名称格律等问题并非一次就能解决。最棘手的是 DeepSeek Flash 难以严格遵循细粒度指令,最终通过提示词优化与后处理器结合的方式才实现稳定运行。
项目结构
src/main/java/com/realikun/aicommand/
├── AICommandMod.java # 主入口
├── ai/
│ ├── AIProvider.java # 后端接口
│ ├── AIProviderRegistry.java # 9 个后端
│ ├── AIRequestBuilder.java # 系统提示词
│ ├── RuleEngineProvider.java # 本地规则引擎
│ ├── LLMApiProvider.java # 云端请求
│ └── CommandCorrector.java # 指令修正
├── command/
│ ├── AICommand.java # /ai
│ └── AIConfigCommand.java # /ai-config
├── config/
│ ├── AIConfig.java # 配置
│ └── ModMenuIntegration.java # ModMenu
├── safety/
│ └── CommandSafetyChecker.java # 安全检查
├── reference/
│ └── MinecraftCommands.java # MC 26.1 命令表
└── mixin/
└── ChatLengthMixin.java # 解除字数限制
许可证
CC0-1.0 — 公有领域。
作者
REALIKUN2024
遇到 Bug 或有建议?请访问 GitHub Issues
你是这个资源的作者?登录后可认领此资源。
相似资源
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
查看物品与配方
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
添加全屏世界地图,显示你在世界中已探索的区域。与 Xaero's Minimap 搭配使用效果极佳。
评论 0
登录后参与评分
还没有评论,来抢沙发吧