AI Command

模组

· 作者 REALIKUN2024

用自然语言+AI控制Minecraft。

0 本站下载 0 关注 更新于 4 个月前

最新 1.0.0-26.2 · 26.2 · Fabric

一键开服(送7天)

English | 简体中文


AI Command

使用自然语言控制 Minecraft。输入 /ai give me a maxed-out diamond sword,AI 会自动生成并执行相应的命令。


功能

  • /ai <text> — 描述你想要的效果,AI 会生成并执行 Minecraft 命令
  • 危险检测 — 破坏性命令(如 ban、kill、fill、explosives)会提示确认
  • 支持多种后端 — 本地规则引擎(免费、离线)+ 9 家云提供商
  • 集成 ModMenu 以提供图形化配置界面
  • 命令修正器 — 自动修复能力较弱的模型产生的旧版语法错误

安装

  1. 安装 Fabric Loader 0.18.5 或更高版本
  2. 安装 Fabric API
  3. 将 ai-command-1.0.0.jar 放入 .minecraft/mods/ 目录
  4. (推荐)安装 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


English | 简体中文


AI指令 (AI Command)

在聊天框中通过自然语言控制 Minecraft。输入 /ai 给我一把满级钻石剑,AI 将为你生成指令并执行。


功能概览

  • /ai <文本> — 用自然语言描述需求,AI 自动生成 Minecraft 指令
  • 危险指令检测 — 对 ban、kill、fill、爆炸物等指令弹出确认框,点击一次即可确认
  • 多后端支持 — 本地规则引擎(离线免费)+ 9 个云端 AI,通过 /ai-config 一键切换
  • ModMenu 图形化配置界面
  • 指令修正器 — 自动修复部分模型输出的旧版 MC 语法

安装

  1. 安装 Fabric Loader 0.18.5+
  2. 安装 Fabric API
  3. 将 ai-command-1.0.0.jar 放入 .minecraft/mods/ 目录
  4. 推荐安装 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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源