tools/raid_bench.py (+ tests): the #147 step-0 driver replaces the #126 scratch script. One battle at fixed ticks (waves inside resident terrain — far waves stall at the unknown-chunk edge and no fight happens), fingerprint chat lines at control ticks, then the raid's own recording replayed. Both render paths are benched on the SAME recording in ONE process via the engine's diagnostic `model-instancing off|on` toggle (cross-process battles diverge in event timing: 16 vs 32 kills at one control tick), pairs in alternating order; idle cold/warm, mid-battle window, reload (F3+T), replay seek, away-camera checks, and static off/on stills for pixel parity (hd_bench motion-mask methodology). report.json carries gitlinks, device, mod_models counters, CPU/GPU p50/p95/p99/max, raw frame times, >25/33 ms frame counts, guest fuel and streaming queues. Engine gitlink: one mass mod-model group GPU-instanced (retained mesh per pack generation, current/previous pose/id/light instance stream shared by main, motion and shadow passes, per-vertex fallback to parity, runtime diagnostic toggle, stats raw + guest fuel reporting). Measurements: docs/measurements/issue-147-instancing/ (M5/Metal, 2560x1440; RTX 3060 pending). docs/REPO-MAP.md and docs/ENGINE.md pin updated. Co-Authored-By: Kimi Code <noreply@moonshot.ai>
8.7 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, tools/raid_bench.py |
Проверочные скрипты (raid_bench — воспроизводимый бой+replay замер рендера, #147) |
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.