Импорт OpenStreetMap и атрибуция данных

Импорт данных OpenStreetMap в World Forge

В руководстве World Forge 0.1.0-preview.1 для Windows x64 и Project Zomboid B42.20.4 описан импорт геометрии OpenStreetMap в виде редактируемых плиток.

Импорт формы местности

Выберите Lib → Import OSM… и загрузите данные XML или PBF. Нативный импортёр преобразует поддерживаемые геометрические формы в редактируемые тайлы. В него включена адаптация алгоритма связанных контуров KnoxMap; указанные авторы — euclid80tr / spytheeuclidean-a11y.

1. Сохраните проект и задайте нужный выбор области и начало координат.
2. Выберите стиль этажей, стен, крыш и дорог; дорожный набор определяет ширину.
3. Загрузите XML или PBF. Координаты вписываются в целевой прямоугольник; метрический масштаб не гарантируется.
4. Осмотрите изгибы, контуры зданий и зелёные зоны. Прочитайте Logs о пропущенных ways.
5. Undo отменяет весь импорт, если размещение или масштаб неверны; redo восстанавливает связанные метаданные.
6. Обычными инструментами добавьте доступ, интерьеры, растительность, точки появления и зоны.

Включённая геометрия

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

Что пока не восстанавливается

В эту preview не входят вода и сопряжение берегов, мосты и тоннели, внутренние дворы multipolygon, реальные высоты, меблированные многоэтажные интерьеры и генерация населения. Лесные зоны не создают деревья. Здания, обрезанные краем прямоугольника, могут иметь открытые границы.

Импорт использует нативный C# и существующий exporter. В программу не встроены полное приложение KnoxMap, генератор на Python или изменённый компилятор WorldEd.

Сохранение и рабочие копии

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

Если сохранение не удалось, проверьте status и Logs. Удачное редактирование не означает успешной записи. Оставьте приложение открытым при устранении проблем с правами или путём; при необходимости используйте Save As в разрешённый каталог. project.lock обычно означает, что проект открыт другой desktop- или MCP-сессией; закройте её штатно.

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

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

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

1. Сохраните отдельный кандидат для релиза.
2. Запустите File → Export as Mod или кнопку Export.
3. Оставьте выход в рабочем каталоге World Forge и проверьте status/Logs.
4. Проверьте структуру B42.20, скомпилированные ячейки, метаданные, spawn, зоны и пользовательские зависимости.
5. Не смешивайте сгенерированный мод с проектом дальнейшего редактирования.

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

Игровая проверка проводится в изолированном свежем профиле: скопируйте туда кандидат, включите зависимости и создайте мир B42.20.4. Проверьте spawn, входы, столкновения, этажи, лестницы, контейнеры и лут, парковку, воду, видимые плитки и границы ячеек; запишите pass/fail перед заявлением о playable.

CLI/MCP smoke-инструменты подготавливают отдельный WorldForge\smoke cachedir и checklist, но не запускают игру и не выставляют pass автоматически. См. docs/IN_GAME_SMOKE.md.

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

В сообщении об ошибке укажите версии World Forge и игры, шаги, мировые/ячеечные координаты, этаж и проекцию; приложите снимок build box и текст ошибки, удалите API keys и личные данные сохранения. Декодирование и каталогизация требуют больше ресурсов, чем повторный просмотр кэшированной ячейки. Assembly показывает большие миры менее подробно; для проверки приблизьте нужный участок.

Границы возможностей preview

Руководство сообщает, что 25 сентября прошли нативные автоматические тесты и Windows desktop smoke harness (viewport, minimap, конвертация и prefab-town); геометрия конвертации также получила независимый аудит синтетических данных. Это не подтверждает прохождение экспортированной карты в Project Zomboid.

Атрибуция, права и ссылки

Авторское и проприетарное содержимое World Forge принадлежит FadedMods.com, Faded Realms Game Studio и TryLisa.ai. Карты, тайловая графика и игровые assets Project Zomboid остаются собственностью The Indie Stone и поставляются через локальную установку пользователя.

ZomboSlicer и его оригинальный разработчик, опубликованный на сайте Stylo: обнаружение спрайтов, очистка выбранного фона и выравнивание пола повлияли на Prepare sprites. Владелец проекта сообщил о разрешении на адаптацию с указанием авторства. KnoxMap от euclid80tr / spytheeuclidean-a11y: алгоритм обхода связанных контуров по лицензии MIT адаптирован для нативной геометрии OSM; Copyright © 2026 spytheeuclidean-a11y. Полный текст находится в docs/licenses/KnoxMap-MIT.txt. Knoxify от arytek — исходный генератор ландшафта, на котором основан KnoxMap. Полное приложение KnoxMap и унаследованный сторонний код не включены.

Для производных карт OSM остаются права и лицензия OpenStreetMap contributors; сохраняйте атрибуцию и ODbL при передаче таких данных. В релиз включены сторонние библиотеки Avalonia, SkiaSharp, HarfBuzz, .NET, SQLite, OsmSharp и другие; применимые уведомления входят в пакет.