Initial Unity 6 scaffold for Cat Kirby Adventures.

Add Phase A greybox vertical slice: third-person movement, forest path, checkpoints, story triggers, and light ability gate.
2026-09-08 17:09:27 +08:00
commit 1c6c9b2a70
44 changed files with 2553 additions and 0 deletions
@@ -0,0 +1,31 @@
+# Карта глав → уровни
+
+Книга разбита на 13 глав. Ниже — план будущих уровней.
+**Phase A (текущий прототип):** только **Level_01_Forest**.
+
+| # | Глава (книга) | Будущий уровень | Статус |
+|---|----------------|-----------------|--------|
+| 1 | Падение | Level_01_Forest (вступление / тропа) | Phase A |
+| 2 | Путь в деревню | Level_01_Forest (продолжение тропы) | Phase A |
+| 3 | Внутренний источник | Level_01_Forest (пьедестал Света) | Phase A |
+| 4 | Ворота / порог деревни | Level_01_Forest (LightGate, финиш среза) | Phase A |
+| 5 | (глава 5) | Level_02_Village | Планируется |
+| 6 | (глава 6) | Level_02_Village / Level_03 | Планируется |
+| 7 | (глава 7) | Level_03 | Планируется |
+| 8 | (глава 8) | Level_04 | Планируется |
+| 9 | (глава 9) | Level_05 | Планируется |
+| 10 | (глава 10) | Level_06 | Планируется |
+| 11 | (глава 11) | Level_07 | Планируется |
+| 12 | (глава 12) | Level_08 | Планируется |
+| 13 | (глава 13) | Level_09_Finale | Планируется |
+
+## Phase A — Level_01_Forest
+
+Runtime-сборка (`Level01ForestBuilder`):
+
+- стартовая площадка и лесная тропа из примитивов;
+- платформы и разрывы;
+- 2–3 чекпоинта + kill-plane;
+- сюжетные объёмы с цитатами в духе глав «Падение», «Путь в деревню», «Внутренний источник»;
+- пьедестал разблокировки Света;
+- ворота деревни с `LightGate` → победа.
@@ -0,0 +1,44 @@
+# GDD — Приключения кота Кирби
+
+## Название
+
+**Приключения кота Кирби** (репозиторий: Cat-Kirby-Adventures).
+
+## Фэнтези
+
+Игрок ведёт чёрного кота Кирби по миру, где внешние препятствия отражают внутренний путь героя.
+Способность **Свет** — проявление внутреннего источника: игрок учится «видеть» и открывать то, что закрыто страхом и тьмой.
+Тон: тёплый, сказочный, с уважением к тексту книги; геймплей — понятный 3D-платформинг от третьего лица.
+
+## Основной цикл (core loop)
+
+1. Исследовать короткий сегмент уровня (тропа / платформы).
+2. Читать сюжетные реплики в триггерах (атмосфера глав).
+3. Преодолевать прыжки и пропасти; сохраняться на чекпоинтах.
+4. Получить способность **Свет** и применить её к реактивным объектам.
+5. Открыть ворота / пройти к следующей зоне → победа на срезе.
+
+## Способность «Свет»
+
+- **Состояние:** заблокирована до пьедестала на середине Level 01.
+- **Ввод:** ЛКМ или E.
+- **Поведение:** короткий raycast вперёд, вспышка LineRenderer, вызов `ILightReactive.OnHitByLight`.
+- **Кулдаун:** ~0.75 с.
+- **Смысл в срезе:** открыть `LightGate` у деревни и завершить уровень.
+
+## Камера
+
+Третье лицо: следование за Кирби, yaw/pitch от мыши, ограничение pitch.
+В прототипе — `SimpleCameraFollow` (без жёсткой зависимости от API Cinemachine 3).
+
+## Объём вертикального среза (Phase A)
+
+| Включено | Не в срезе |
+|----------|------------|
+| Level_01_Forest (runtime greybox) | Полные уровни глав 5–13 |
+| Движение, прыжок, чекпоинты | Боевая система, инвентарь |
+| Свет + одни ворота | Много врагов / квесты |
+| 2–3 сюжетных оверлея | Полный диалоговый UI / озвучка |
+| Пауза, win-state | Сохранения на диск, меню настроек |
+
+Цель среза: доказать фан «книга → платформер» и петлю «движение → история → Свет → ворота».