MCAI Assistant
AI-мод для сервера и клиента Minecraft — подключается к API, совместимому с OpenAI.
Fabric
- Загрузчики
- Fabric
- Скачиваний на Modrinth
- 481
- Подписчиков на Modrinth
- 1
- версий
- 5
- Обновлён
- 19 сентября 202619 сент.
- Опубликован
- в 2026
Коротко о моде
Работает на Fabric
Для Minecraft 26.1–26.3
Нужен на сервере; в игре — по желанию
Последняя версия — 1.7.1 от 19 сентября 2026
Лицензия MIT — бесплатно
Где нуженВерсии игры26.1–26.3
В игренеобязателенНа сервереобязателен
Нужен на сервере; в игре — по желанию
Описание переведено автоматическиПоказать оригинал (EN)
MCAI - Minecraft AI Assistant
MCAI — это мод для Fabric, который позволяет ИИ управлять вашим сервером Minecraft. Весь проект разработан ИИ.
Кратко: Игроки пишут /ai how do I enchant a diamond sword?, ИИ отвечает. Кто-то ругается? ИИ предупреждает или кикает. Опасные операции требуют одобрения админа.
Быстрый старт
| Что | Как |
|---|---|
| Чат с ИИ | /ai <вопрос> или !ai <вопрос> |
| ИИ выполняет команды | /ai give me a diamond sword (одобрение админа) |
| Пакет команд ИИ | /ai build a redstone circuit (цепочка команд, одно одобрение) |
| Проверить счёт поведения | /aiscore |
| Поиск по вики | /aikb enchantment (доступна онлайн-вики) |
| Одобрение админа | `/aiaccept одобрить //aireject ` отклонить |
| Отмена ожидающих | /aicancel отменить последнюю / /aicancel all отменить все |
Возможности
Чат с ИИ
- Игроки используют
!aiили/aiдля общения с ИИ - ИИ имеет полный контекст сервера (логи чата, погода, время, игроки)
- Многоходовой диалог с историей
- Режим персоны: переключение персоны ИИ через
/aipersona— встроенные темы жителя, пиглина, Ender Dragon, Creeper, двуязычные (ZH/EN), админы могут добавлять свои персоны вconfig/mcai/personas/
Автоматическая проверка поведения
- ИИ анализирует чат каждые 30 минут
- Трёхуровневое наказание: снижение счёта -> жёлтая карточка -> красная карточка (кик)
- Сообщения админов считаются доверенными; админы могут объявлять правила сервера
Одобрение админа
- Опасные команды (op, ban, kick) требуют ручного одобрения админа
- Таймаут 3 минуты автоматически отменяет ожидающие одобрения
- Строгий режим: только безопасные команды из белого списка пропускают одобрение
- Текст ИИ, начинающийся с
/, блокируется; все команды должны проходить через систему Tool и единый поток одобрения - Цепочка команд: ИИ может объединять несколько команд в одну единицу одобрения (
execute_command_chain), админ одобряет один раз для выполнения всех, с настраиваемыми интервалами между командами - Отмена игроком: Игроки могут использовать
/aicancelдля отмены своих ожидающих команд; ИИ получает уведомление об отмене и не повторяет ту же команду
База знаний об игре
- ИИ ищет на minecraft.wiki / zh.minecraft.wiki онлайн актуальные знания об игре (язык через
wikiLanguage) - Поддерживает поиск на китайском и английском, возвращает сводки и ссылки на полные страницы
Установка
Требования
- Minecraft Fabric server 26.x
- Java 25
- DeepSeek API Key (или любой OpenAI-совместимый API)
Шаги
- Скачайте последний JAR
- Поместите его в папку
mods/ - Запустите сервер для автосоздания конфига
- Отредактируйте
config/mcai/config.json, впишите ваш API Key - Конфиг перезагружается автоматически; или запустите
/aireloadвручную
Использование в одиночной игре
Мод работает и в одиночной игре (выделенный сервер не нужен):
- Установите Fabric client (та же версия 26.x)
- Поместите JAR в папку
.minecraft/mods/ - Запустите игру и войдите в мир одиночной игры
- Конфиг и команды идентичны серверной настройке
- Вы владелец мира с полными правами админа по умолчанию
- (Опционально) Установите Mod Menu для редактирования конфига в игре
Совет: Система проверки поведения автоматически отключается в одиночной игре (не нужно проверять себя).
Команды
Команды игрока
| Команда | Описание |
|---|---|
`!ai /ai ` | Чат с ИИ |
/aiscore | Проверить счёт поведения |
/aicancel [id/all] | Отменить свои ожидающие команды |
Команды администратора
| Команда | Описание |
|---|---|
| `/aiaccept ` | Одобрить ожидающее действие |
| `/aireject ` | Отклонить ожидающее действие |
/aiquery | Показать список ожидающих одобрений (с уникальными id) |
/aiclear | Очистить историю чата с ИИ |
/aireload | Вручную перезагрузить конфиг (автоперезагрузка при изменении файла) |
/airesetprompts | Сбросить файлы промптов к текущим встроенным значениям по умолчанию |
| `/aikb ` | Поиск по базе знаний Wiki |
/aicontrol [chat/review] [on/off] | Включить/выключить чат/проверку ИИ |
/aikill | Уничтожить все потоки ИИ |
/aidebug start/stop/show/list/clear | Логирование отладки |
/aipersona [list/set/current/view/reload] | Переключить/просмотреть/перезагрузить персону ИИ |
Управление проверками
| Команда | Описание |
|---|---|
/aireview start | Запустить проверку вручную |
| `/aireview approve ` | Одобрить кик |
| `/aireview reject ` | Отклонить кик |
/aireview last | Показать результат последней проверки |
/aireview last reasoning | Показать рассуждения ИИ |
Тестовые команды (только для OP)
| Команда | Описание |
|---|---|
| `/aitest score ` | Проверить счёт поведения игрока |
| `/aitest set ` | Установить счёт поведения игрока |
| `/aitest penalty ` | Симулировать штраф |
| `/aitest reset ` | Сбросить счёт поведения игрока |
/aitest review | Запустить проверку вручную |
/aitest chatlog | Показать лог чата |
Конфигурация
Файл: config/mcai/config.json. Автоперезагрузка при изменении (или используйте /aireload).
| Ключ | По умолчанию | Описание |
|---|---|---|
apiEndpoint | https://api.deepseek.com | Эндпоинт API (без /chat/completions, формат зависит от провайдера) |
apiKey | "" | Ключ API |
model | deepseek-v4-flash | Название модели |
triggerPrefix | !ai | Префикс-триггер в чате |
maxTokens | 2048 | Максимум токенов ответа |
temperature | 0.75 | Случайность ответа (0-1) |
thinkingLevel | 1 | Уровень размышлений 0-3 |
strictMode | true | Строгий режим |
aiCooldownSeconds | 60 | Кулдаун ИИ для не-админов (секунды) |
aiMaxConcurrent | 3 | Максимум одновременных вызовов ИИ для не-админов |
compatibilityMode | false | Режим совместимости: отправлять только базовые поля для локальных API вроде LM Studio |
enableStream | false | Потоковый вывод (SSE), некоторые API поддерживают только потоковый режим |
reviewIntervalMinutes | 30 | Интервал проверок (мин) |
yellowCardThreshold | -30 | Порог жёлтой карточки |
redCardThreshold | -60 | Порог красной карточки |
scoreRecoveryPerInterval | 5 | Восстановление счёта за цикл |
approvalTimeoutMinutes | 10 | Таймаут одобрения (мин) |
wikiLanguage | "zh_cn" | Язык онлайн-поиска ИИ: zh_cn китайский, en_us английский (онлайн-поиск включён по умолчанию) |
apiConnectTimeoutSeconds | 10 | Таймаут подключения к API (секунды) |
apiRequestTimeoutSeconds | 60 | Таймаут одного запроса к API (секунды) |
apiLoopTimeoutSeconds | 300 | Общий таймаут цикла вызова инструментов (секунды) |
commandExecTimeoutSeconds | 30 | Таймаут выполнения одной команды (секунды) |
wikiConnectTimeoutSeconds | 5 | Таймаут подключения при поиске по Wiki (секунды) |
wikiRequestTimeoutSeconds | 8 | Таймаут запроса при поиске по Wiki (секунды) |
maxChainCommands | 10 | Максимум команд в цепочке |
contextMaxChars | 20000 | Максимум символов контекста для ИИ (автообрезка) |
maxToolCalls | 15 | Максимум вызовов инструментов за один ход диалога |
activePersona | "default" | ID текущей персоны |
personaLanguage | "" | Переопределение языка персоны, пусто=следовать языку клиента |
promptLanguage | "zh_cn" | Язык встроенных промптов |
enableChatInterception | true | Перехватывать чат и передавать ИИ |
enableCommandExecution | true | Разрешить ИИ выполнять команды |
enableAutoReview | true | Включить автопроверку поведения |
maxReviewCycles | 4 | Максимум циклов анализа проверки |
systemPromptPath | "" | Файл системного промпта (в config/mcai/) |
reviewPromptPath | "" | Файл промпта проверки |
reviewApiEndpoint | "" | Эндпоинт API системы проверки, пусто=следовать конфигу чата |
reviewApiKey | "" | Ключ API системы проверки, пусто=следовать конфигу чата |
reviewModel | "" | Модель системы проверки, пусто=следовать конфигу чата |
Файлы промптов system_prompt.txt / review_prompt.txt создаются автоматически при первом запуске. Выполни /airesetprompts, чтобы принудительно синхронизировать их с текущими встроенными версиями.
База знаний
Поиск по базе знаний ИИ выполняется через онлайн-вики — ручной импорт данных не нужен.
Ссылки
Лицензия
MIT License
Частые вопросы
Как установить MCAI Assistant?
Установите Fabric под свою версию Minecraft, скачайте MCAI Assistant под ту же версию и загрузчик, положите файл в папку mods и запустите игру с профилем загрузчика.
Для каких версий Minecraft есть MCAI Assistant?
У MCAI Assistant есть сборки для Minecraft 26.1–26.3.
Нужен ли MCAI Assistant на сервере?
Нужен на сервере; в игре — по желанию
Лицензия и источник
MIT Licenseможно свободно использовать и распространять с указанием автора
