AI Builder - Minecraft AI Assistant

Руководство пользователя AI Builder

Версия 1.4.0 | Minecraft 1.20.4 | Мод Fabric

Установка

Требуется Minecraft 1.20.4, Fabric Loader 0.15.0 или новее, Java 17 или новее и Fabric API. Установи эти зависимости, положи ai-builder-1.4.0.jar в .minecraft/mods/, затем запусти игру и нажми K.

Первоначальная настройка

При первом запуске создаётся ai-helper/config/ai-builder.properties. Укажи свой API-ключ перед использованием ИИ:

/aiconfig api_base_url YOUR_API_URL
/aiconfig api_key YOUR_API_KEY
/aiconfig model YOUR_MODEL_NAME

Также можно нажать K → AI Chat Settings. Поддерживаются OpenAI-совместимые API и Anthropic Messages API. api_format=auto выбирает формат по эндпоинту; отредактируй конфиг, чтобы явно использовать openai или anthropic, затем при необходимости выполни /aiconfig reload.

Горячие клавиши

Переназначить K можно в Настройки → Управление → Назначения клавиш в разделе AI Builder. Остальные клавиши — фиксированные элементы управления экранов.

Команды

Команды ИИ и утилиты

Команды настройки

/aiconfig — не универсальная команда «ключ/значение». Скриншоты, контекст, стриминг и язык меняются в экранах настроек; api_format редактируется прямо в файле конфигурации с последующей перезагрузкой.

Команды структур

У /ainbt нет GUI без аргументов. Открой графический браузер через K → Load Structures.

Пересылка логов чата и «Generate Test Logs» предоставляются опциональным модом debug-menu, а не командами AI Builder.

Возможности

Чат с ИИ и строительство

Открой AI Chat клавишей K или используй `/ai `. Интерфейс чата поддерживает до 20 сообщений (10 обменов) истории, ввод до 1024 символов, ссылки на TXT-чертежи, отмену запроса и потоковый вывод по мере поступления. Захват скриншотов по умолчанию отключён.

ИИ может ставить, заполнять или очищать блоки; выдавать предметы; призывать сущностей; задавать время/погоду; телепортировать; создавать и размещать чертежи. Операция заполнения или очистки ограничена 10 000 блоков, give — 64 предметами, а призыв сущностей — 20 сущностями. execute_command выполняется с уровнем прав 2, но небезопасные команды администрирования сервера, модерации и root-команды stop/save отклоняются; ИИ не может выполнять произвольные ванильные команды.

Координаты в чертежах относительные: X — восток, Y — вверх, Z — юг, начало координат — у ног игрока. Поддерживаются чертежи V1 и MCBLUEPRINT v2 в формате TXT.

Единый браузер структур

Откройте Load Structures из меню K, чтобы просматривать, искать, удалять и размещать файлы в подпапках:

• ai-helper/structures/nbts/ для файлов .nbt;
• ai-helper/structures/litematic/ для файлов .litematic;
• ai-helper/structures/txts/ для чертежей V1/V2 в .txt.

При размещении NBT/Litematica пропускаются air и structure_void, сохраняются состояния блоков, данные блоков-сущностей и сущности структур. Старый формат данных табличек конвертируется в формат 1.20+. Сгенерированные ИИ чертежи TXT сохраняются в ai-helper/structures/txts/ai-generated/.

Инструмент выделения

Откройте Selection Tool из меню K. Задайте две угловые координаты (или используйте текущую позицию), подтвердите, чтобы отрисовать подсветку, затем проанализируйте/экспортируйте выделение. Черновые координаты сохраняются при закрытии экрана.

• TXT / MCBLUEPRINT v2: всегда экспортирует содержимое контейнеров и непустой текст на табличках спереди/сзади.
• NBT: сохраняет данные блоков-сущностей.
• Litematica: сохраняет данные блоков-сущностей и может включать сущностей.

Веб-поиск, загрузка страниц и скриншоты

Для веб-поиска требуются web_search_enabled=true и tavily_api_key. Когда ИИ запрашивает поиск, мод обращается к Tavily за максимум пятью результатами с таймаутом 120 секунд. ИИ также может запросить загрузку веб-страницы; таймаут — 30 секунд, а полученный простой текст ограничен 8 000 символов.

Когда включён screenshot_enabled, интерфейс чата закрывается на два тика перед созданием снимка экрана шириной до 512 px. Он временно сохраняется как ai-helper/screenshots/ai_chat_temp.png; путь для скриншота команды /ai — ai_temp.png.

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

Файл конфигурации: ai-helper/config/ai-builder.properties

AI Chat Settings управляет четырьмя булевыми настройками. Экран настроек API позволяет изменить конечную точку, ключ, модель и ключ Tavily. После ручных правок выполните /aiconfig reload. Язык меняется через K → Mod Language; при следующем запуске клиента он сбрасывается на текущий язык Minecraft.

Формат чертежа

# 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

Строка блока V2 — это `x,y,z   block_id   [key=value ...]`. `# name:`, `# size:` и `# origin:` — необязательные метаданные; строки, начинающиеся с `#`, — комментарии. Старые чертежи V1 в виде символьной сетки остаются совместимыми: строки идут на юг, столбцы — на восток, пробелы означают воздух.

## Структура файлов

```text
.minecraft/
├── ai-helper/
│   ├── config/ai-builder.properties
│   ├── structures/
│   │   ├── nbts/
│   │   ├── litematic/
│   │   └── txts/
│   │       └── ai-generated/
│   └── screenshots/
│       ├── ai_temp.png
│       └── ai_chat_temp.png
└── mods/ai-builder-1.4.0.jar

Все папки структур поддерживают произвольную вложенность.

FAQ и примечания

ИИ не отвечает: выполните /aiconfig show, чтобы проверить ключ и endpoint, затем проверьте доступ к сети. Необязательное меню отладки может предоставить логи чата для диагностики.

Смена языка или стриминга: используйте K → Mod Language и K → AI Chat Settings соответственно. Команд /aiconfig language или /aiconfig stream_output_enabled нет.

Ручное изменение конфигурации: выполните /aiconfig reload; перезапуск не нужен.

Безопасность и производительность: API-ключи хранятся локально. Операции ИИ необратимы, поэтому делайте резервные копии важных миров. Поиск и загрузка отправляют запросы во внешние сервисы. Размещение больших структур может вызвать кратковременные лаги.

Лицензия

MIT License

Автор: liuzeen1234 Исходный код: https://github.com/liuzeen1234/minecraft-AI-helper