Go to file
z.kirill 4382af2322 Документация: границы движка, работа через модель, дизайн игры до лейтгейма
18-engine.md    границы Tile2D, проекции 2D, формат проекта, второй проект
  19-agent.md     инструменты --tool, скиллы, терминал в редакторе
  20-gdd.md       акты, петли, рост отряда, закон масштаба, бюджет 200 часов
  21-damage.md    семь стихий, статусы, десять реакций, формулы, триггеры
  22-loot.md      редкости, аффиксы, артефакты, зачарования, материалы
  23-endgame.md   Бездна, мутации, лидерборды, 262 ачивки

Плюс правки 01/02/07/15/16/17 под переехавшие пути и новые правила забега.

Дизайнерская часть держится на одном законе: угроза растёт квадратично, сила
отряда — линейно с затуханием, разрыв закрывается ЗНАНИЕМ, а не числами. Из
него выведены и экономика опыта (41 млн против 44 млн дохода), и то, почему
реакции считаются от глубины, а не от урона оружия, и почему в Бездне
множитель HP разрешён, а во всём авторском контенте запрещён.

.claude/commands: скиллы /tile2d, /room, /floor — правила этого движка,
которые нельзя вывести из кода. Главное записано первым: не отчитываться об
успехе без прохода --tool validate.

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

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-13 21:07:45 +03:00
.claude/commands Документация: границы движка, работа через модель, дизайн игры до лейтгейма 2026-08-13 21:07:45 +03:00
.vscode Прототип боевого ядра: отряд, хоррор-слой, ближний бой 2026-08-03 13:00:49 +03:00
assets Конвейер ассетов: манифесты, риги, каталоги, инструменты 2026-08-13 21:06:09 +03:00
docs Документация: границы движка, работа через модель, дизайн игры до лейтгейма 2026-08-13 21:07:45 +03:00
editor Tile2D: движок отдельным продуктом, игра — проектом в нём (M11-M20) 2026-08-13 21:07:19 +03:00
engine Tile2D: движок отдельным продуктом, игра — проектом в нём (M11-M20) 2026-08-13 21:07:19 +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
samples/walk Tile2D: движок отдельным продуктом, игра — проектом в нём (M11-M20) 2026-08-13 21:07:19 +03:00
src Tile2D: движок отдельным продуктом, игра — проектом в нём (M11-M20) 2026-08-13 21:07:19 +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-13 21:07:45 +03:00
CMakeLists.txt Tile2D: движок отдельным продуктом, игра — проектом в нём (M11-M20) 2026-08-13 21:07:19 +03:00
main.code-workspace Tile2D: движок отдельным продуктом, игра — проектом в нём (M11-M20) 2026-08-13 21:07:19 +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.