English | 简体中文

AI Command

Control Minecraft with natural language. Type /ai give me a maxed-out diamond sword and the AI figures out the commands.

Features

• /ai <text> — describe what you want, AI generates and executes Minecraft commands
• Danger detection — destructive commands (ban, kill, fill, explosives) prompt for confirmation
• Multiple backends — local rule engine (free, offline) + 9 cloud providers
• ModMenu integration for graphical config
• Command corrector — auto-fixes legacy syntax from less capable models

Installation

1. Install Fabric Loader 0.18.5+
2. Install Fabric API
3. Drop ai-command-1.0.0.jar into .minecraft/mods/
4. (Recommended) Install ModMenu for a config GUI

Requires Minecraft 26.1 and Java 25+.

Usage

/ai give me 64 diamonds
/ai switch to creative mode
/ai give me a maxed-out netherite sword
/ai spawn a zombie named Bob

Safe commands run immediately. Dangerous ones ask you to click [Confirm].

All config via commands:

/ai-config                          # show current config
/ai-config provider deepseek        # switch backend
/ai-config apikey sk-xxx            # set API key
/ai-config model deepseek-chat      # change model
/ai-config test                     # test connection

Or open ModMenu, click "AI Command", and use the GUI.

Configuration

AI Backends

Dangerous Command Categories

Customize with /ai-config danger add|remove.

Model Recommendations

DeepSeek Chat has been tested the most and handles MC 26.1's new syntax best.

The Flash variant is cheaper but occasionally outputs legacy syntax — the built-in CommandCorrector cleans this up, so the difference is minimal in practice. If Flash fails on a complex request, switch to deepseek-v4-pro for noticeably better instruction following.

Claude, GPT-4o, Qwen, and others haven't been thoroughly tested. Any OpenAI-compatible API should work in theory.

Commands are not guaranteed 100% correct. Minecraft's command system has too many edge cases. Please report bugs on the issue tracker and include a log snippet (/ai-config log true to enable).

Development

Built with Claude Code. The process involved:

Extracting command registries, NBT tag names, and entity attributes from MC 26.1 source, cross-referencing against zh.minecraft.wiki, and iterating on prompt engineering across many rounds. Legacy syntax, NBT case sensitivity, and attribute naming were recurring pain points. DeepSeek Flash refusing to follow fine-grained instructions was the hardest — solved with prompt refinement plus a post-processing corrector.

Project Structure

src/main/java/com/realikun/aicommand/
├── AICommandMod.java              # Entry point
├── ai/
│   ├── AIProvider.java            # Backend interface
│   ├── AIProviderRegistry.java    # 9 providers
│   ├── AIRequestBuilder.java      # System prompt
│   ├── RuleEngineProvider.java    # Local rule engine
│   ├── LLMApiProvider.java        # Cloud API calls
│   └── CommandCorrector.java      # Syntax correction
├── command/
│   ├── AICommand.java             # /ai
│   └── AIConfigCommand.java       # /ai-config
├── config/
│   ├── AIConfig.java              # Config management
│   └── ModMenuIntegration.java    # ModMenu UI
├── safety/
│   └── CommandSafetyChecker.java  # Danger detection
├── reference/
│   └── MinecraftCommands.java     # MC 26.1 command reference
└── mixin/
    └── ChatLengthMixin.java       # Chat limit removal

License

CC0-1.0 — public domain.

Author

REALIKUN2024

Bugs? Suggestions? 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 后端

危险指令分类

五类指令弹确认窗：

/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