AI Command

AI Command

Управляй Minecraft естественным языком. Напиши /ai дай мне максимально зачарованный алмазный меч, и ИИ сам разберётся с командами.

Возможности

• /ai <текст> — опиши, что хочешь, ИИ сгенерирует и выполнит команды Minecraft
• Обнаружение опасных команд — разрушительные команды (ban, kill, fill, взрывчатка) требуют подтверждения
• Несколько бэкендов — локальный движок правил (бесплатно, офлайн) + 9 облачных провайдеров
• Интеграция с ModMenu для графической настройки
• Корректор команд — автоматически исправляет устаревший синтаксис от менее способных моделей

Установка

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 заспавни зомби с именем Bob

Безопасные команды выполняются сразу. Опасные просят нажать [Подтвердить]. Вся настройка через команды:

/ai-config                          # показать текущую конфигурацию
/ai-config provider deepseek        # сменить бэкенд
/ai-config apikey sk-xxx            # задать API-ключ
/ai-config model deepseek-chat      # сменить модель
/ai-config test                     # проверить соединение

Или открой ModMenu, нажми «AI Command» и используй графический интерфейс.

Конфигурация

Бэкенды ИИ

Категории опасных команд

Рекомендации по моделям

DeepSeek Chat тестировался больше всего и лучше всех справляется с новым синтаксисом MC 26.1. Вариант Flash дешевле, но иногда выдаёт устаревший синтаксис — встроенный CommandCorrector это чистит, так что на практике разница минимальна. Если Flash не справляется со сложным запросом, переключись на deepseek-v4-pro — следование инструкциям заметно лучше. Claude, GPT-4o, Qwen и другие тщательно не тестировались. Любой API, совместимый с OpenAI, в теории должен работать. Команды не гарантированно на 100% правильные. В командной системе Minecraft слишком много крайних случаев. Пожалуйста, сообщай о багах в трекере задач и прикладывай фрагмент лога (/ai-config log true для включения).

Разработка

Сделано с помощью Claude Code. Процесс включал: Извлечение реестров команд, имён NBT-тегов и атрибутов сущностей из исходников MC 26.1, сверку с 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
├── safety/
│   └── CommandSafetyChecker.java  # Обнаружение опасных команд
├── reference/
│   └── MinecraftCommands.java     # Справочник команд MC 26.1
└── mixin/
    └── ChatLengthMixin.java       # Снятие ограничения длины чата

Лицензия

CC0-1.0 — общественное достояние.

Автор

REALIKUN2024 Баги? Предложения? GitHub Issues

AI指令 (AI Command)

• Графическая настройка через ModMenu

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-config                          # посмотреть текущую конфигурацию
/ai-config provider deepseek        # переключиться на DeepSeek
/ai-config apikey sk-xxx            # задать API-ключ
/ai-config model deepseek-chat      # сменить модель
/ai-config test                     # проверить соединение

|------|------|------|---------| | rule_engine | Локальный движок правил | Офлайн | Нет | | deepseek | DeepSeek (рекомендуется) | Облако | Да | | claude | Claude | Облако | Да | | openai | OpenAI | Облако | Да | | glm | GLM | Облако | Да | | moonshot | Moonshot | Облако | Да | | ollama | Ollama | Локально | Нет |

| 不可逆 | /ban, /kill, /stop, /clear | | 爆炸物 | /summon tnt, /give end_crystal | | 危险召唤 | /summon creeper, /summon wither | | 可能破坏 | /fill, /clone, /setblock | | 重大影响 | /gamerule, /difficulty |

真遇到 Flash 翻车，换 deepseek-v4-pro，指令遵循度明显上一档。 遇到 Bug 请提 Issue，顺便 /ai-config log true 开个日志，把那段贴过来。

在 Claude Code 辅助下完成开发。

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       # 解除字数限制

REALIKUN2024 GitHub Issues