c08b737296
build / mod (push) Failing after 32s
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>
66 lines
8.7 KiB
Markdown
66 lines
8.7 KiB
Markdown
# Карта репозитория
|
||
|
||
Что здесь что: исходники, сгенерированное, архив. Порядок сборки и установки — в `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`.
|