Files
sindoring d229117a23 Add NPC authoring, custom appearances and bilingual quests
Support project-local editing of existing NPC services and quest links,
with guarded migrations and preserved server data. Add custom appearance
artifacts, Russian-first quests with independent English text, and the
local D0 launcher and content catalog.

Validation: cargo fmt --all; cargo clippy --workspace --all-targets --
-D warnings; cargo test --workspace (106 passed, 0 failed, 32 ignored).

Co-Authored-By: Codex <noreply@openai.com>
2026-11-14 18:43:02 +04:00

22 KiB
Raw Permalink Blame History

D0: прототип локального тестового мира

Этот документ описывает общий запуск редактора и изолированного игрового сервера. Цель D0 — доказать способ доставки готовых компонентов до создания мастера D1. Приёмка на чистой Windows остаётся отдельным условием завершения этапа.

Контракт прототипа

Общий запуск из checkout выполняется через scripts/start-editor.ps1 -WithRuntime. Скрипт собирает редактор, подготавливает сервер, проверяет готовность и открывает редактор с подключённой БД. Вариант scripts/start-editor.ps1 запускает редактор отдельно; в готовом ZIP этот вариант использует поставленный exe без Cargo. Для просмотра мира нужны собственные ресурсы WoW. Каталог и серверные проверки требуют подключения к БД.

Серверный кандидат использует готовые образы Docker через WSL2. Прототип создаёт отдельные сеть, контейнеры и БД, использует другие порты на loopback и собственные секреты. Исходники ядра и установленная игра остаются входами только для чтения. Живые аккаунты, персонажи, пароли и БД владельца не копируются. Собственные миграции контента из checkout ядра не входят в исходный снимок мира.

Воспроизводимость проверяется по идентификаторам образов, ревизии схемы и хешу исходного снимка. Наличие локального образа с тегом dev само по себе не доказывает соответствие текущему исходному коду ядра. Успешный импорт и старт подтверждают проверенную комбинацию, но не создают отсутствующую цепочку происхождения бинарного файла.

Сравнение вариантов

Вариант Доступные основания Что ещё требуется
Готовые процессы Windows: vMaNGOS и MariaDB Предпочтительный кандидат ROADMAP; не требует Linux VM В этом окружении не найдены готовый Windows сервер и воспроизводимый pipeline его поставки; запуск, зависимости и остановка не проверены
Готовые Linux образы через WSL2 и Docker Доступны образы сервера и MariaDB, статический world seed, схемы и производные данные карт Изолированный импорт, запуск и остановка; затем упаковка входов независимо от checkout, доставка runtime и приёмка на чистой Windows

Для локального экспериментального прогона выбран второй вариант: он позволяет проверить новую БД и мир без сборки сервера. Это пока не окончательный выбор runtime для всех пользователей. WSL2, виртуализация и Docker являются реальными предпосылками этого прототипа. Их установка, права администратора и возможная перезагрузка не проверены на чистой машине и не скрываются за командой запуска.

Запуск прототипа

Из PowerShell в checkout редактора:

./scripts/start-editor.ps1 -WithRuntime
./scripts/d0-runtime.ps1 -Action status -Name mw-editor-d0-local
./scripts/d0-runtime.ps1 -Action down -Name mw-editor-d0-local

Первая команда собирает редактор, поднимает окружение mw-editor-d0-local, ждёт готовности БД, авторизации и мира, затем проверяет все три опубликованных порта из Windows и открывает редактор. Для уже собранного release есть -NoBuild, для другого окружения — -RuntimeName. После закрытия редактора сервер продолжает работать, остановка выполняется командой down. Повторный запуск использует существующую БД и фактические порты сохранённого manifest.

Профиль редактора создаётся в %LOCALAPPDATA%/MoonWell/Editor/d0/<имя окружения>. Скрипт автоматически записывает адрес изолированной world-базы в config/settings.json. Секрет поступает внутри helper из закрытого состояния WSL. Пароль хранится в локальном JSON профиля по текущему формату редактора. Сам профиль и его настройки содержат секреты и предназначены для локального использования. Обычный профиль продолжает обслуживать отдельный запуск редактора.

Для своих ресурсов WoW задайте -WowDataDirectory 'C:/Games/World of Warcraft/Data'. При первом запуске доступный путь подставляется из обычных настроек; при повторном сохраняется путь отдельного профиля. Стартовое окно позволяет выбрать ресурсы и проект. Для прямого открытия проекта используется -EditorArguments @('C:/Content/camp.json'). Явный -ProfileDirectory принимает пустой каталог или профиль, созданный этим helper для того же окружения. Унаследованные настройки подключения окружения очищаются на время запуска, затем восстанавливаются.

Общий запуск доступен в исходном checkout. В portable ZIP используется отдельный запуск редактора. Для ручного управления сервером остаётся scripts/d0-runtime.ps1 -Action up.

По умолчанию входы берутся из /home/sindo/core, данные — из deploy/local/data этого checkout. Для другого расположения есть -CoreDirectory и -DataDirectory; это абсолютные пути внутри WSL. Требуются WSL, Python 3.11 или новее, работающий Docker с Compose и уже доступные закреплённые образы. Скрипт не скачивает образы и не собирает сервер. Порты по умолчанию: БД 127.0.0.1:13806, авторизация 127.0.0.1:13724, мир 127.0.0.1:18085; для нового окружения есть -DatabasePort, -AuthPort, -WorldPort.

Состояние хранится в WSL: ~/.local/share/moonwell-editor/d0/<имя>, либо в явно выбранном -StateDirectory. Каталог закрыт от других пользователей Linux, секреты генерируются заново и не печатаются. Здесь находятся manifest.json, снимок схем/миграций и world seed, compose.json, last-start.json с временем готовности и очищенный от известных секретов diagnostics.log. Секреты и целый каталог состояния нельзя публиковать или прикладывать к отчёту. Для диагностики достаточно проверенных файлов без секретов.

up ждёт успешного завершения инициализации БД, затем настраивает realm и проверяет доступность портов авторизации и мира внутри контейнеров. По умолчанию лимит — 900 секунд, изменяется через -TimeoutSeconds. Это не проверка входа игрока через Windows. При ошибке первого запуска скрипт пытается остановить контейнеры выбранного окружения, сохраняя БД и журнал. Если в нём уже работали службы до вызова, окружение сохраняется работающим для диагностики. Ошибка проверки опубликованных портов из Windows также оставляет runtime работающим и показывает команду проверки состояния. down останавливает и удаляет контейнеры/сеть своего окружения, но сохраняет тома БД и журналов. Посторонние службы и окружение владельца не останавливаются.

Неудачный первоначальный импорт не считается готовой БД. Для нового импорта после такой ошибки используйте новое имя окружения; существующий том сохраняется для диагностики. Автоматическое удаление или восстановление повреждённого окружения относится к D2.

Результаты локального прогона 2026-11-14

Общий запуск проверен командой ./scripts/start-editor.ps1 -NoBuild -WithRuntime -RuntimeName mw-editor-d0-acceptance с явным путём к WoW Data и диагностическому проекту. Сохранённая БД стала готова за 7.80 секунды, мир — за 12.67 секунды. Helper создал отдельный профиль с подключением к 127.0.0.1:13806/mangos, все три опубликованных порта доступны из Windows. Редактор загрузил мир и каталог. Кадр target/d0-unified-start/world-catalog.png показывает результаты запроса Kobold, включая Kobold Vermin и Kobold Miner, и 293 серверных спавна. Поиск задан через диагностический параметр, ручные действия в интерфейсе не выполнялись. Процесс завершился с кодом 0, runtime оставлен работающим. Первая попытка с перенаправлением вывода обнаружила прерывание wrapper на диагностическом stderr движка в PowerShell 5. Обработка исправлена, повтор с журналом и кадром target/d0-unified-start/redirected.png завершился с кодом 0. Прошли 11 Python-тестов и scripts/test_start_editor.ps1. Последний проверяет изоляцию и восстановление переменных, сохранение обычного профиля, обработку повреждённых настроек и устаревшего пути WoW Data, отказ от импорта стороннего окружения в профиль runtime. Созданная им временная копия исполняемого файла удалена. Rust-код и release-сборка в этом дополнении не менялись. После диагностики редактор повторно открыт общим запуском без автоматического закрытия, с проектом target/d0-smoke/probe.json. В окне подтверждены мир и 293 серверных спавна. Профиль находится в %LOCALAPPDATA%/MoonWell/Editor/d0/mw-editor-d0-acceptance.

Редактор собран заново из текущего checkout. Portable ZIP открыт из пути с пробелами и кириллицей, с пустым EDITOR_HOME: стартовое окно показало выбор проекта и настройки. Второй запуск использовал новый пустой проект и собственный WoW Data без подключения БД. Через 30 секунд получен кадр 1600×900 с загруженным миром и зданием; процесс завершился с кодом 0. Снимок — target/d0-smoke/world.png, описание — target/d0-smoke/verification.md. Интерактивное редактирование, экспорт и Play этим запуском не проверялись.

В отдельном серверном окружении mw-editor-d0-proof2 статический импорт завершился за 160.36 секунды; авторизация и мир стали доступны за 171.45 секунды после подготовки снимка входных файлов, от начала запуска контейнеров. Доступность трёх опубликованных портов 13806, 13724 и 18085 дополнительно проверена из Windows через 127.0.0.1. Вход игрока не проверялся. Времена относятся к этой машине с уже имеющимися образами и игровыми данными, без загрузки и установки WSL/Docker.

Повторный свежий импорт окончательной версии скрипта в mw-editor-d0-acceptance подтвердил создание manifest с хешами вспомогательных файлов штатным путём: БД готова за 212.59 секунды, мир — за 217.51 секунды. Manifest вручную не менялся.

После штатной остановки повторный запуск этого же окружения дал 7.67 секунды до БД и 12.68 секунды до мира. Повторная доступность портов из Windows подтверждена. Проверены 175 таблиц world-базы, 0 аккаунтов и 0 персонажей: данные живых игроков не копировались. Измеренный каталог БД занимает 640 191 142 байта, приватное состояние со снимком SQL — 202 047 757 байт. Снятый в покое расход памяти контейнеров: БД 115.7 MiB, авторизация 2.422 MiB, мир 260.9 MiB; игроков нет, это не системные минимумы.

После исходных проверок контейнеры и сети всех трёх тестовых окружений остановлены и удалены; тома БД и журналов сохранены согласно контракту down. Чтобы повторно открыть именно проверенное окружение, используйте ./scripts/d0-runtime.ps1 -Action up -Name mw-editor-d0-acceptance, затем тот же вызов с -Action down. Имя по умолчанию mw-editor-d0-local оставлено свободным для нового мира.

Шесть проверок из scripts/test_d0_runtime.py прошли без Docker и БД владельца: исключение пользовательского контента и обнаружение подмены снимка, отказ на неизвестный том журналов, занятый порт до создания ресурсов, очистка секретов в диагностике, порядок остановки мира перед БД и отказ при неверном владельце/конфигурации состояния. Проверены синтаксис PowerShell, Python и Bash и хеши файлов пакета. Rust-проверки также прошли: форматирование, Clippy workspace/all-targets с -D warnings, 60 тестов workspace; 5 opt-in тестов штатно пропущены, ошибок нет. Журнал и сводка: target/d0-runtime-checks/cargo-test.log, target/d0-runtime-checks/report.json.

Первая попытка mw-editor-d0-proof завершилась до импорта SQL из-за прав доступа к bind-mounted скрипту. Контейнеры этой попытки остановлены, причина исправлена и новый импорт выполнен в отдельном томе. Это обнаруженная и исправленная ошибка прототипа, а не успешный первоначальный прогон. Каталоги состояния/секретов имеют режим 0700; файлы, читаемые пользователями внутри контейнеров, доступны им для чтения.

Исходные данные исследования

Исследование выполнено 2026-11-14. Локально доступны Docker 28.0.4 и Compose 2.34.0. Входы находятся в /home/sindo/core, ревизия на момент исследования — ed6eea2f4. Прототип не меняет этот репозиторий.

  • Серверный образ: sha256:d759d063561780cc60d1a3f526cb924273d43b1020d3b6310fc25115136a0336, размер образа по Docker — 56 158 759 байт; связь сборки с ревизией ядра не подтверждена.
  • MariaDB 10.11: sha256:7db29378d4fdab73f8123bbc2b48905c90d1a4b00cf848b028f1e81e623257f2, размер образа по Docker — 104 174 329 байт.
  • database/mangos.sql: около 137 MiB, SHA-256 7c5c064a160a2e65b55b94d65cce26a19bac40f33b83454d5e89ecc2667fe8cf.
  • Данные клиента для сервера: dbc около 28 MiB, maps 279 MiB, vmaps 574 MiB, mmaps 2.0 GiB. Это локальные данные собственной установки, а не разрешение включать игровые файлы в распространяемый пакет.

Размер образа Docker не равен размеру скачивания или всей установки. Размеры выше — инвентаризация локальных входов, не минимальные системные требования и не бюджет первого запуска. Точные требования требуют отдельного измерения готового поставляемого пакета.

Незакрытые условия D0

  • Чистая поддерживаемая Windows без Rust, Git, настроенной БД и серверных исходников.
  • Независимый пакет server seed/schema/data с происхождением, версиями и проверкой совместимости, без ссылок на личный checkout разработчика.
  • Совместимая готовая клиентская сборка с доказанной ревизией. Найденный локально MoonWell 0.3.2 от 2026-11-08 не имеет подтверждённой связи с закреплённой ревизией Benilla редактора; имя папки и отсутствие .probe-identity этого не доказывают.
  • Подготовка тестового аккаунта и персонажа. Штатные команды account create и account set gmlevel описаны в play.md; обычный персонаж создаётся в клиенте. Автоматическое создание персонажа для поставляемого player-клиента ещё не подтверждено.
  • Замеры загрузки, диска, памяти, времени первого запуска и обновления на чистой машине; проверка native Windows кандидата до окончательного решения о runtime.
  • Сквозная приёмка «проект → NPC → Play» и прохождение человеком. Открытое окно редактора или слушающий порт мира не считаются таким прохождением.