AI Builder - Minecraft AI Assistant

Мод AI Builder - Minecraft AI Assistant для Minecraft 1.20.4

AI Builder — это мод для Minecraft 1.20.4, работающий на платформе Fabric. Он превращает игру в пространство, где игрок может взаимодействовать с искусственным интеллектом для решения игровых задач. Мод позволяет строить сложные конструкции по текстовому описанию, управлять загруженными структурами (NBT, Litematica, TXT), искать информацию в интернете и выполнять утилитарные команды. Все действия выполняются через чат или специальные команды, при этом мод поддерживает многостраничный контекст диалогов и интеграцию с внешними API.

Основной функционал и взаимодействие с ИИ

Сердцем мода является чат-интерфейс, который открывается по умолчанию на клавишу K или через команду /ai. ИИ способен выполнять широкий спектр действий: от простого размещения блоков и предметов до сложной генерации структур, телепортации игроков и изменения погоды. Интерфейс поддерживает историю диалога до 20 сообщений (10 ходов) и позволяет отправлять запросы длиной до 1024 символов. Для работы с текстовыми схемами (blueprints) поддерживается формат MCBLUEPRINT v2, что позволяет загружать и использовать внешние файлы для автоматического строительства. Выход данных от ИИ происходит потоково (incremental streaming), что дает возможность видеть процесс генерации по мере его выполнения. По умолчанию функция захвата скриншотов отключена, но может быть включена в настройках.

Управление структурами и импортом файлов

Мод предоставляет мощный инструмент для работы с файлами структур. Через главное меню (доступно по K) игрок может открыть браузер структур, где можно просматривать, искать, удалять и размещать файлы. Поддерживаются три основных формата: .nbt файлы (в папке nbts/), файлы .litematic (в папке litematic/) и текстовые схемы V1/V2 (в папке txts/). При размещении структур мод автоматически пропускает блоки типа air и structure_void, сохраняя при этом состояния блоков, данные сущностей и блок-сущностей. ИИ также способен генерировать новые текстовые схемы, которые автоматически сохраняются в подпапку ai-generated/ внутри директории структур. Файлы структур могут храниться в произвольно вложенных папках для удобного управления библиотекой.

Инструмент выделения и экспорт данных

Для анализа и переноса реального игрового мира в структуры предусмотрен инструмент выделения. Он доступен в меню мода и позволяет задать две угловые точки выделения (или использовать текущую позицию игрока). После подтверждения система рисует выделение на экране и позволяет проанализировать или экспортировать его. Экспорт поддерживает разные форматы в зависимости от типа структуры: для TXT и MCBLUEPRINT v2 всегда сохраняются инвентари контейнеров и текст вывесок; для NBT и Litematica сохраняются данные блок-сущностей и, в случае Litematica, данные сущностей. Координаты в экспортируемых схемах относительны: ось X указывает на восток, Y — вверх, Z — на юг, а начало координат находится у ног игрока.

Поиск информации и работа с внешними сервисами

AI Builder интегрируется с внешними поисковыми сервисами для предоставления игроку актуальной информации. Для активации функции веб-поиска необходимо включить соответствующий параметр в настройках и предоставить ключ API сервиса Tavily. При запросе ИИ поиск возвращает до пяти результатов с тайм-аутом 120 секунд. Мод также поддерживает функцию получения (fetch) содержимого веб-страниц, которая имеет тайм-аут 30 секунд и ограничивает полученный текст 8000 символами. Все запросы к внешним сервисам выполняются локально и не передают игровые данные на сторонние серверы, кроме самих запросов к поисковой системе.

Ограничения безопасности и производительности

Безопасность является приоритетом при работе с ИИ. Мод не позволяет выполнять произвольные команды ванильного Minecraft через ИИ, блокируя опасные действия администратора, модуляцию и команды остановки/сохранения сервера. Команды execute_command выполняются с уровнем прав 2. Ограничения также касаются объема операций: заполнение или очистка территории ограничена 10 000 блоков, выдача предметов — 64 шт., а спавн сущностей — 20 штук. Важно помнить, что все действия ИИ необратимы, поэтому перед использованием рекомендуется создавать резервные копии миров. Ключи API хранятся локально на компьютере пользователя.

Настройка конфигурации и параметров

Поведение мода регулируется файлом ai-helper/config/ai-builder.properties. Здесь можно задать базовый URL API, ключ доступа и модель для использования. Также доступны настройки для включения захвата скриншотов, контекста для многоходовых диалогов, веб-поиска и потоковой передачи ответов. Параметр api_format позволяет выбрать формат запроса: автоматический (auto), OpenAI или Anthropic. Язык интерфейса можно переключать между en_us и zh_cn через меню настроек или файл конфигурации. После ручного редактирования файла необходимо выполнить команду /aiconfig reload для применения изменений без перезапуска игры.

Система команд и управление

Мод предоставляет обширный набор команд для ручного управления. Основные команды для общения с ИИ включают /ai для чата, /ai blueprints для списка загруженных схем и /ai test_stairs для отладки. Для управления конфигурацией используются команды /aiconfig, позволяющие менять URL, ключи API, модель и настройки поиска. Специальные команды /ainbt позволяют работать с NBT и Litematica структурами напрямую, включая их размещение у ног игрока. Для отмены текущего запроса используется /aistop, а /ainew очищает историю диалога. Команды для навигации по файлам структур и управления выделением также доступны в терминале.

Формат MCBLUEPRINT v2

Для текстовых схем мод использует формат MCBLUEPRINT v2, который отличается от старых версий. Каждая строка описывает блок через координаты x,y,z, идентификатор блока и ключевые параметры (например, axis=y, distance=4, waterlogged=false). Комментарии в файле начинаются с символа #. Метаданные, такие как название, размер и начало координат, также указываются в комментариях. Ориентация координат при создании схемы: X — восток, Y — вверх, Z — юг, начало — у ног игрока. Мод совместим и с устаревшим форматом V1, где строки идут на юг, а колонны — на восток, а пробелы означают воздух.

Управление и привязки клавиш

Основное взаимодействие с модом происходит через привязку клавиши K, которая открывает меню настроек и инструментов. В этом меню доступны подменю: "AI Chat Settings", "Mod Language", "Selection Tool" и "Load Structures". Клавиша Enter отправляет сообщение в чат или размещает структуру в браузере. Escape закрывает экран мода. Колесико мыши и клавиши Page Up/Page Down используются для прокрутки списков. В настройках управления игроку можно переназначить клавишу K, однако другие клавиши являются жестко закрепленными элементами интерфейса.

Сравнение форматов экспорта структур

Параметры конфигурации (ai-builder.properties)

Пример структуры MCBLUEPRINT v2

# MCBLUEPRINT v2
# name: example
# size: 5x6x5
# origin: 0,0,0
# Origin: structure northwest corner on the lowest layer; x=east, y=up, z=south
# Format: x,y,z  block_id  [key=value ...]

## BLOCKS

# --- Layer 1 (y=0) ---
2,0,2   oak_log   axis=y
3,0,2   short_grass
0,0,3   short_grass
2,0,4   short_grass
4,0,4   short_grass

# --- Layer 2 (y=1) ---
2,1,2   oak_log   axis=y

# --- Layer 3 (y=2) ---
0,2,0   oak_leaves   distance=4   persistent=false   waterlogged=false
1,2,0   oak_leaves   distance=3   persistent=false   waterlogged=false
2,2,0   oak_leaves   distance=2   persistent=false   waterlogged=false
3,2,0   oak_leaves   distance=3   persistent=false   waterlogged=false
0,2,1   oak_leaves   distance=3   persistent=false   waterlogged=false
1,2,1   oak_leaves   distance=2   persistent=false   waterlogged=false
2,2,1   oak_leaves   distance=1   persistent=false   waterlogged=false
3,2,1   oak_leaves   distance=2   persistent=false   waterlogged=false
4,2,1   oak_leaves   distance=3   persistent=false   waterlogged=false
0,2,2   oak_leaves   distance=2   persistent=false   waterlogged=false
1,2,2   oak_leaves   distance=1   persistent=false   waterlogged=false
2,2,2   oak_log   axis=y
3,2,2   oak_leaves   distance=1   persistent=false   waterlogged=false
4,2,2   oak_leaves   distance=2   persistent=false   waterlogged=false
0,2,3   oak_leaves   distance=3   persistent=false   waterlogged=false
1,2,3   oak_leaves   distance=2   persistent=false   waterlogged=false
2,2,3   oak_leaves   distance=1   persistent=false   waterlogged=false
3,2,3   oak_leaves   distance=2   persistent=false   waterlogged=false
4,2,3   oak_leaves   distance=3   persistent=false   waterlogged=false
1,2,4   oak_leaves   distance=3   persistent=false   waterlogged=false
2,2,4   oak_leaves   distance=2   persistent=false   waterlogged=false
3,2,4   oak_leaves   distance=3   persistent=false   waterlogged=false
4,2,4   oak_leaves   distance=4   persistent=false   waterlogged=false

# --- Layer 4 (y=3) ---
1,3,0   oak_leaves   distance=3   persistent=false   waterlogged=false
2,3,0   oak_leaves   distance=2   persistent=false   waterlogged=false
3,3,0   oak_leaves   distance=3   persistent=false   waterlogged=false
0,3,1   oak_leaves   distance=3   persistent=false   waterlogged=false
1,3,1   oak_leaves   distance=2   persistent=false   waterlogged=false
2,3,1   oak_leaves   distance=1   persistent=false   waterlogged=false
3,3,1   oak_leaves   distance=2   persistent=false   waterlogged=false
4,3,1   oak_leaves   distance=3   persistent=false   waterlogged=false
0,3,2   oak_leaves   distance=2   persistent=false   waterlogged=false
1,3,2   oak_leaves   distance=1   persistent=false   waterlogged=false
2,3,2   oak_log   axis=y
3,3,2   oak_leaves   distance=1   persistent=false   waterlogged=false
4,3,2   oak_leaves   distance=2   persistent=false   waterlogged=false
0,3,3   oak_leaves   distance=3   persistent=false   waterlogged=false
1,3,3   oak_leaves   distance=2   persistent=false   waterlogged=false
2,3,3   oak_leaves   distance=1   persistent=false   waterlogged=false
3,3,3   oak_leaves   distance=2   persistent=false   waterlogged=false
4,3,3   oak_leaves   distance=3   persistent=false   waterlogged=false
0,3,4   oak_leaves   distance=4   persistent=false   waterlogged=false
1,3,4   oak_leaves   distance=3   persistent=false   waterlogged=false
2,3,4   oak_leaves   distance=2   persistent=false   waterlogged=false
3,3,4   oak_leaves   distance=3   persistent=false   waterlogged=false

# --- Layer 5 (y=4) ---
2,4,1   oak_leaves   distance=1   persistent=false   waterlogged=false
1,4,2   oak_leaves   distance=1   persistent=false   waterlogged=false
2,4,2   oak_log   axis=y
3,4,2   oak_leaves   distance=1   persistent=false   waterlogged=false
2,4,3   oak_leaves   distance=1   persistent=false   waterlogged=false

# --- Layer 6 (y=5) ---
2,5,1   oak_leaves   distance=2   persistent=false   waterlogged=false
1,5,2   oak_leaves   distance=2   persistent=false   waterlogged=false
2,5,2   oak_leaves   distance=1   persistent=false   waterlogged=false
3,5,2   oak_leaves   distance=2   persistent=false   waterlogged=false
2,5,3   oak_leaves   distance=2   persistent=false   waterlogged=false

Список основных команд

Важные оговорки и безопасность

AI Builder не поддерживает прямые вызовы инструментов через API сервера, поэтому используется текстовый протокол. Функции "Forwarding chat-log" и "Generate Test Logs" предоставляются опциональным модом debug-menu, а не командами самого AI Builder. Все действия ИИ необратимы, поэтому перед использованием рекомендуется создавать резервные копии миров. Ключи API хранятся локально на компьютере пользователя. Мод не позволяет выполнять произвольные команды ванильного Minecraft через ИИ, блокируя опасные действия администратора, модуляцию и команды остановки/сохранения сервера. Команды execute_command выполняются с уровнем прав 2. Ограничения также касаются объема операций: заполнение или очистка территории ограничена 10 000 блоков, выдача предметов — 64 шт., а спавн сущностей — 20 штук.

Связанные материалы

• YetAnotherConfigLib (YACL) — похожий мод
• Cherished Worlds — похожий мод
• Forge Config Screens — похожий мод

Автор: liuzeen1234 · Лицензия: MIT