chexit
ead87343d2
catalog/specs.json is now the single copy of the numeric rows for
DroneSpec, MissileSpec and SamSpec: speed, guidance, warheads, models'
parts, RCS, seekers, launch and motor sounds, mount drives, gravity,
the Oreshnik split height and logistics limits, plus the named part
sets. tools/gen_catalog.py generates airdef-mod/src/sim/specs_generated.rs
(included by mod.rs, so the mod and airdef-core compile the same rows)
and unit_specs_generated.rs (included by units.rs). The hand-written
spec matches are gone; DroneKind::spec, MissileKind::spec and
SamKind::spec read the generated constants.
load_specs validates the schema, sound references, kind coverage against
content.json, named-part references and unused rows. gen_catalog.py
--check already runs in the CI generated-assets step, so a JSON/Rust
drift fails the build.
Every value was compared with the literals at 632061d field by field.
The only mismatch was the P1-SUN motor voice pitch in JSON (1.6 instead
of the actual 1.7, the flame == 0 branch in voices.rs); the JSON was
corrected and behaviour is unchanged. Save keys, raid order, RNG and
gameplay traces are untouched.
Verified: core release 194 passed + 8 scenarios (7 ignored), adapter
64 unit + 1 boundary + 5 scenarios, WASM contract 27 steps, catalog and
model generators fresh, asset/sound/model-bound/report tests pass.
8.6 KiB
Карта репозитория
Что здесь что: исходники, сгенерированное, архив. Порядок сборки и установки — в README.md и docs/INSTALL.md.
Исходники (правим руками)
| Путь | Что это |
|---|---|
airdef-mod/src/, airdef-mod/shaders/ |
Мод на Rust (WASM) для форка Horizon |
airdef-core/ |
SDK-free сборка того же ядра из airdef-mod/src/sim/; не отдельная копия исходников |
airdef-mod/src/sim/battery.rs, launch.rs, logistics.rs |
Конфигурация батареи, физические ячейки/крышки и снабжение |
docs/CODEX-HANDOFF.md, docs/IMPLEMENTATION-STATUS.md |
Техническая передача разработки и фактический статус задач |
airdef-mod/Cargo.toml, horizon-mod.toml |
Сборка мода |
airdef-mod/tests/, airdef-mod/examples/ |
Тесты и примеры |
airdef-mod/NOTES-terrain-guidance.md |
Рабочие заметки по рельефу |
horizon/, .gitmodules |
Закреплённый сабмодуль отдельного форка Horizon |
tools/airdef.py |
Сборка мода и установка в папку игры |
tools/gen_models.py, tools/gen_tex.py, tools/gen_sounds.py |
Генераторы контента (см. ниже) |
tools/acoustics_check.py, tools/hd_bench.py |
Проверочные скрипты |
docs/ |
Документация (этот файл, INSTALL.md, ACOUSTICS.md, HD-RENDERER.md) |
install.sh, play.sh, dist/ |
Установка и запуск |
run-home/, run-home-bench/, run-home-smoke/ |
Тестовые игровые папки, не часть мода |
screenshots/ |
Скриншоты |
Сгенерировано (не правим руками)
tools/gen_models.py создаёт:
airdef-mod/assets/airdef/{blockstates,models,items,lang,textures}/airdef-mod/data/airdef/horizon/
Список этих файлов с sha256 лежит в airdef-mod/generated-manifest.txt. Генератор пишет во временный каталог, проверяет набор (ссылки моделей, blockstate и текстур; JSON; PNG; координаты элементов; парность lang) и только потом переносит файлы. При ошибке проверки ничего не записывается. Файл, который правили вручную или который занимает путь генерируемого, останавливает запуск (КОНФЛИКТ).
Команды:
python3 -m pip install -r tools/requirements.txt— зависимости генератора (закреплён Pillow).python3 tools/gen_catalog.py— обновить Rust-константы после измененийcatalog/content.json,catalog/specs.jsonилиcatalog/sounds.json;--checkпроверяет актуальность.python3 tools/gen_models.py— перегенерировать.python3 tools/gen_models.py --check— только сравнить, выход 1 при различиях.
catalog/specs.json — единственный источник числовых профилей симуляции: строки DroneSpec, MissileSpec/MissileKind (включая RCS, seeker, звук пуска и голос мотора), SamSpec (оружие, части моделей, приводы, датчик), общие константы (гравитация, высота раскрытия «Орешника», логистика) и именованные наборы частей. tools/gen_catalog.py создаёт из него airdef-mod/src/sim/specs_generated.rs (включается в mod.rs; тот же файл компилирует airdef-core) и airdef-mod/src/sim/unit_specs_generated.rs (включается в units.rs). Эти два файла не редактировать вручную. tools/airdef_assets/catalog.py::load_specs проверяет схему, звуковые ссылки, наборы kinds против content.json, ссылки на именованные части и заполненность всех строк; gen_catalog.py --check в CI ловит расхождение. Значения — игровой масштаб, не реальные характеристики техники.
catalog/sounds.json хранит звуковые ID, дальности и наличие дальнего варианта; tools/gen_catalog.py экспортирует ID для Rust, а tools/gen_sounds.py создаёт airdef-mod/assets/airdef/sounds/*.ogg и sounds.json. Этот генератор не использует manifest и не входит в проверку gen_models.py.
Архив: legacy/
Первая версия мода: датапак на командах (legacy/airdef-datapack/) и контент-мод (legacy/airdef-content/) с генератором legacy/gen_content.py. Ничего из текущей сборки на него не ссылается: ни скрипты в tools/, ни install.sh, ни Cargo.toml, ни исходники мода. Не собирается и не устанавливается. Оставлен как история. Не редактировать и не удалять без отдельного решения.
legacy/airdef-content/data/ сейчас не отслеживается git и не входит в эту карту.
Авторские и сгенерированные ресурсы
tools/gen_models.pyгенерирует геометрию моделей и управляет сборкой набора.tools/airdef_assets/registry.pyсоздаёт blockstate/item registry, локализацию и data JSON.tools/airdef_assets/bounds.pyэкспортирует габариты итоговых моделей для headless-навигации; authored overrides входят в расчёт.tools/gen_tex.pyотвечает за вывод процедурных текстур и иконок; переиспользуемые примитивы палитры также находятся здесь.tools/airdef_assets/texture_catalog.pyсвязывает стабильную палитру и процедурные функции с текстурами моделей, не смешивая каталог с геометрией.catalog/content.jsonзадаёт идентичности техники и предметов и оформление предметов;tools/airdef_assets/icons.pyчитает его и содержит чистую функцию рендера иконки с явными параметрами(name, color, seed).tools/airdef_assets/pipeline.pyпроверяет manifest, рассчитывает безопасный план обновления и откатывает записи при исключении.airdef-mod/source-assets/assets/airdef/— источник авторских переопределений. Генератор объединяет его с процедурными ресурсами во временном дереве, проверяет ссылки/JSON/PNG, затем устанавливает runtime-файлы.airdef-mod/assets/иairdef-mod/data/— упакованные generated output. Не редактируйте их вручную; добавляйте авторские исходники вsource-assets.airdef-mod/generated-manifest.txtхранит SHA-256 только для управляемого результата. Неизменённые старые outputs можно заменить или удалить; посторонние и вручную правленные файлы блокируют конфликтующий запуск.python3 tools/test_gen_assets.pyпроверяет manifest, защиту ручных файлов, откат при ошибке записи, детерминизм и полный цикл authored icon override/validation.
airdef-mod/src/sim/generated_bounds.rs также управляется manifest: это данные геометрии, а не файл для ручного редактирования. Пилотный арт и сравнения — в docs/MODEL-PILOTS.md.