Go to file
z.kirill f637a07d72 Содержимое двух проектов: DESCENT и HOLLOW
Игра стала проектом движка, и её содержимое переехало из assets/ в projects/.

  projects/descent  сама игра: восемь комнат, каталог из 28 сущностей,
                    изометрия, кривая спуска на сто этажей
  projects/hollow   второй проект: вид сверху, четыре комнаты, свой каталог,
                    короткая и злая кривая

Второй проект существует не для примера. Движок с одним проектом ничем не
отличается от игры с красиво названными каталогами, и проверить, что зашитых
знаний про DESCENT в движке не осталось, можно только вторым проектом
(docs/18-engine.md).

Он же сразу окупился: --check нашёл в комнате maw глухую камеру посередине —
ту же ошибку, что когда-то в storage. На сетке она выглядит нормально, но
точка спавна внутри недостижима, и этаж тихо становится легче.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-13 21:06:28 +03:00
.vscode Прототип боевого ядра: отряд, хоррор-слой, ближний бой 2026-08-03 13:00:49 +03:00
assets Конвейер ассетов: манифесты, риги, каталоги, инструменты 2026-08-13 21:06:09 +03:00
docs Прототип боевого ядра: отряд, хоррор-слой, ближний бой 2026-08-03 13:00:49 +03:00
generated Конвейер ассетов: манифесты, риги, каталоги, инструменты 2026-08-13 21:06:09 +03:00
lib Прототип боевого ядра: отряд, хоррор-слой, ближний бой 2026-08-03 13:00:49 +03:00
projects Содержимое двух проектов: DESCENT и HOLLOW 2026-08-13 21:06:28 +03:00
src Прототип боевого ядра: отряд, хоррор-слой, ближний бой 2026-08-03 13:00:49 +03:00
tools Конвейер ассетов: манифесты, риги, каталоги, инструменты 2026-08-13 21:06:09 +03:00
.gitattributes Прототип боевого ядра: отряд, хоррор-слой, ближний бой 2026-08-03 13:00:49 +03:00
.gitignore Не тащить в историю кеши, бэкапы и чужие ассеты 2026-08-13 21:04:55 +03:00
CLAUDE.md Прототип боевого ядра: отряд, хоррор-слой, ближний бой 2026-08-03 13:00:49 +03:00
CMakeLists.txt Прототип боевого ядра: отряд, хоррор-слой, ближний бой 2026-08-03 13:00:49 +03:00
main.code-workspace Прототип боевого ядра: отряд, хоррор-слой, ближний бой 2026-08-03 13:00:49 +03:00
Makefile Прототип боевого ядра: отряд, хоррор-слой, ближний бой 2026-08-03 13:00:49 +03:00
preview.jpg Прототип боевого ядра: отряд, хоррор-слой, ближний бой 2026-08-03 13:00:49 +03:00
README.md Прототип боевого ядра: отряд, хоррор-слой, ближний бой 2026-08-03 13:00:49 +03:00
SQUAD_PROTOTYPE_SPEC.md Прототип боевого ядра: отряд, хоррор-слой, ближний бой 2026-08-03 13:00:49 +03:00

Squad prototype — тактический отряд с авто-огнём

Технический прототип боевого ядра 2D-изометрического sci-fi horror roguelite. Отряд из 5 агентов сам расставляется так, чтобы стрелять и не задевать своих. Двое из пяти работают клинком: у ближнего боя то же правило в угловой форме — свой в секторе замаха, значит удара не будет.

боевой кадр с оверлеем

C++17 · raylib 6.0 · CMake · софтверный рендер (вся сцена — ручная запись пикселей в свой фреймбуфер 480×270, апскейл ×3).

Быстрый старт

cmake -S . -B build                                  # разово, тянет raylib 6.0
cmake --build build --config Release --parallel
build/bin/squad_proto.exe

В VS Code — просто F5.

WASD двигает якорь отряда, Space — ручное прицеливание, 1/2/3 — строй, F1..F4 — оверлей. Стрельба всегда автоматическая. Полный список — в документации.

Самопроверка

build/bin/squad_proto.exe --accept        # критерии приёмки, PASS/FAIL
build/bin/squad_proto.exe --headless 300  # прогон без окна + метрики

Симуляция детерминирована и не зависит от рендера, поэтому критерии проверяются цифрами: FRIENDLY_HITS = 0 за 3 минуты боя смешанным отрядом, FIRE UPTIME 100 % в стоячем бою, расхождение веером за 0.18 с, 81 взмах клинком без единого задетого своего, шаг симуляции 2 мкс при бюджете кадра 16.6 мс.

Документация

Оглавление — CLAUDE.md. Модульная документация в docs/:

  • 00-overview — что это и чего тут нет
  • 01-build-and-run — сборка, управление, dev-режимы
  • 02-architecture — модули, порядок шага, правила зависимостей
  • 03-rendering — фреймбуфер, изометрия, спрайты
  • 04-world — карта, рейкаст, коллизии, мишени
  • 05-squad-aiядро: линии огня, решатель, резервирование
  • 06-debug-and-tuning — оверлей, метрики, тюнинг
  • 07-milestones — журнал вех
  • 08-decisions — отклонения от спека и почему
  • 09-acceptance — критерии приёмки и цифры
  • 10-atmosphere — свет, туман войны, трассеры, напряжение
  • 11-meleeближний бой: сектор удара, три фазы, свой круг

Исходное ТЗ: SQUAD_PROTOTYPE_SPEC.md.


Проект вырос из шаблона Raylib-CPP Starter Template for VS Code; от шаблона остался только Makefile, который больше не используется — сборка через CMake.