AI-помощник World Forge: осмотр, prefab-город и экспорт

Настройка AI-помощника и работа с текущей картой

World Forge 0.1.0-preview.1 — редактор карт для Windows x64; в руководстве указана версия Project Zomboid B42.20.4. Этот материал охватывает настройку необязательного AI-помощника, осмотр здания на экране, создание prefab-города и связанные указания о сохранении, проверке и устранении неполадок.

Настройте необязательного помощника

Откройте Console → Assistant. Выберите Provider, Chat model и при необходимости Image model. Введите ключ провайдера в поле пароля и нажмите Save. Для пользовательской или локальной конечной точки задайте API base URL, если поле доступно.

Модели в выпадающих списках — примеры конфигурации, а не гарантия доступа для вашей учётной записи. Если нужно, введите поддерживаемый провайдером идентификатор в редактируемое поле модели. Для локального чата нужен работающий совместимый сервер и модель с поддержкой инструментов.

Вкладка On this PC сканирует установленные инструменты и распространённые локальные серверы; Scan обновляет результат, зелёный индикатор означает, что сервер работает. Ollama и LM Studio могут обслуживать встроенный чат. Обнаруженный терминальный агент не становится автоматически встроенным HTTP-сервером.

Диалог и данные

Сообщения идут по времени; ответы дописываются в последнюю реплику. Статус вызова инструмента показывает, что помощник осматривает или строит. Stop отменяет локальный запуск. Copy или Copy last копирует ответ. В завершённой части отменённого или неудачного запроса могли остаться изменения: проверьте карту и при необходимости используйте Undo.

DeepSeek получает структурированный текст, а не PNG окна карты; deepseek-chat — рекомендуемый в настройках вариант для отзывчивой работы с инструментами. Совместимые vision-модели могут получить изображение текущего build box и координаты.

Попросите AI осмотреть здание на экране

Оставьте целевое здание видимым в Cell build box. По возможности выберите его в дереве Rooms или расположите в центре кадра.

Инструмент look_viewport читает текущую камеру, масштаб, этаж, видимые слои, активную ячейку и выбор. Он возвращает кандидатов-зданий, комнаты, координаты дверей и окон с направлением. Совместимая vision-модель также получает PNG только из build box; текстовая модель — структурированное описание.

Рабочий цикл наведения

1. Попросите осмотр до перемещения камеры или редактирования.
2. Если подходят несколько зданий, уточните нужное выбором, расположением или выданным ID.
3. Опишите ограниченное изменение, например, сохранив окна, стены и внутренние двери.
4. Попросите проверить подходящие плитки и существующие стопки до размещения.
5. Проверьте изменённый вид и отмените неподходящие изменения.

Инструмент использует загруженные спрайты и метаданные здания. Крыша или объекты переднего плана могут закрыть часть объекта; пиксельная видимость не гарантируется. Нарисованная, но не назначенная структура может не иметь building ID. Скрытые слои, отсутствующие текстуры и обзор Assembly ограничивают ответ. Система сообщает о неоднозначности, загрузке и обрезанных подробностях.

Внешний MCP-инструмент wf_look запрашивает собственную сессию карты; это не потоковая камера рабочего стола.

Попросите построить prefab-город

Инструменты ищут загруженный участок естественной земли, проверяют стопки и этажи на препятствия, затем подготавливают квартал из четырёх участков с внутренними улицами. Цель — жилые дома и коммерческий участок. Если нужная роль недоступна, в отчёте указывается замена. При наличии дороги проверяется коридор подключения.

Планировку могут блокировать дороги, здания, заборы, вода, метаданные комнат, неизвестные этажи, содержимое подвала/верхних этажей, заблокированные слои и незагруженные промежутки. Подсказка Inspect на обзорном экране не означает подтверждённое свободное место: откройте ячейку и запустите проверку.

Успешная операция объединяет участки, дороги, комнаты, здания, точки появления и зоны в одно отменяемое изменение. Неудачный план не меняет рабочий мир. Активный проект сохраняется, кроме случаев, когда нужен или запрошен новый.

Для точных требований явно назовите их — например, школа, клиника, пять домов или двухэтажный магазин. Попросите найти полные префабы и сообщить о недоступных ролях, не выдавая стандартную планировку за точное совпадение.

• «Перечисли реальные здания и число комнат, которые ты разместил».
• «Осмотри каждый вход и соединение с дорогой; сообщи, что нельзя проверить».
• «Добавь точку появления безработного на подходящем этаже, затем проверь и сохрани».

Сохранение и восстановление

Используйте File → Save или Ctrl+S после значимых изменений. Save As создаёт отдельно названный снимок. Open Project продолжает сохранённую работу; неактивные ячейки остаются частью проекта при перемещении.

Если сохранение не удалось, прочитайте status и Logs. Успешное редактирование и успешное сохранение — разные результаты. Не закрывайте приложение при проблеме записи/пути; при необходимости используйте Save As в разрешённый каталог проекта. Ошибка сохранения не доказывает, что предыдущие правки не произошли.

Закрытие проекта и переключение защищены от незаметной потери несохранённой работы. Сообщение project.lock обычно означает, что проект занят другой desktop- или MCP-сессией; штатно закройте ту сессию и повторите.

Перед экспериментом закройте проект и скопируйте всю его папку. Сохраните нужные custom assets библиотеки и исходные зависимости модов. Не распространяйте весь пользовательский каталог: там могут быть ключи, извлечённая игровая графика и личные данные.

Проверка, экспорт и игровой тест

Выберите Tools → Validate и изучите Validation. Исправьте отсутствующие или пустые точки появления, имена комнат, размеры парковок, проблемы water zones, отверстия в этажах и неразрешённые плитки. Чистый отчёт охватывает проверки редактора, но не симулирует игровой процесс.

1. Сохраните проект-кандидат для релиза.
2. Выберите File → Export as Mod или Export на панели.
3. Оставьте выход в рабочей области World Forge export; проверьте status и Logs.
4. Проверьте структуру B42.20, скомпилированные ячейки, метаданные, точки появления, зоны и пользовательские зависимости.
5. Держите сформированный мод отдельно от проекта, который продолжаете редактировать.

Экспортёр создаёт полную замену ячейки, а не разреженный runtime patch. Результат включает скомпилированные участки и может включать статические chunk-заготовки, файлы world-map/biome, Lua-метаданные и custom assets. Некоторые исходные sidecar-файлы и динамическое поведение модов требуют отдельной обработки.

Игровая проверка: скопируйте кандидат в отдельный тестовый профиль mods, включите зависимости и создайте новый мир B42.20.4. Проверьте точки появления, входы, столкновения, этажи, лестницы, контейнеры, добычу, парковки, воду, видимые плитки и границы ячеек. Зафиксируйте pass/fail до распространения как игрового мода. CLI/MCP smoke-инструменты готовят отдельный WorldForge\smoke cachedir и checklist; они не запускают игру и сами не отмечают успешный тест.

Неполадки и производительность

Чтобы отправить полезный отчёт, включите версию релиза и игры, шаги, координаты ячейки/мира, этаж и проекцию. Приложите снимок build box и текст ошибки; исключите API-ключи и приватные данные сохранения.

Декодирование и сканирование каталога требуют больше ресурсов, чем повторный просмотр ячейки из кэша. Assembly снижает детализацию большого мира; точную визуальную проверку выполняйте при приближении рабочего режима.

Границы preview