Files
Diabolo/HANDOFF.md
T

165 lines
16 KiB
Markdown
Raw Normal View History

# Handoff — Diabolo / DEMON
Обновлено: 2026-10-28. Рабочая версия: `Demon_v0.19`.
## С чего продолжать
- Актуальные исходники, ассеты и тесты: `Demon_v0.19/`.
- Движок: Godot 4.3 stable. Git-ветка: `main`.
- Репозиторий: https://gt.arcade.4bqb.com/jariko/Diabolo.git
- Большие `.glb` хранятся в Git LFS. После клонирования выполнить `git lfs pull`.
- Старые папки версий, ZIP, готовые Windows-сборки, движок и кэш остаются локально.
Имеющаяся локальная сборка EXE устарела относительно исходников.
- Для запуска текущего состояния открывать `Demon_v0.19/project.godot`.
Инструкции сборки и запуска — в `README.md`.
## Последние выполненные задачи
- Новый актуальный ориентир пользователя после красного комплекта: три вида
суккубы (спереди, сзади и сбоку), чёрное бикини и броня/ботфорты на каблуках,
длинный высокий чёрный хвост волос, длинные рога, низкие коричневые крылья
с кожистой неровной перепонкой и тонкий шипастый хвост. Запрошены максимальная
точность, реализм и качество текстур. У пользователя нет исходного 3D-файла
и ссылки на автора; это реконструкция по изображениям, точное совпадение
исходной сетки и текстур не подтверждено. Этот референс заменяет красный
комплект ниже. Исправление стоп и слабое покачивание крыльев сохраняются.
- Подготовлен **образец на согласование**, ещё не включённый в игровую сцену:
`Demon_v0.19/reviews/heels_v01`. Пользователь запросил каблуки и исправление
стоп при ходьбе, затем уточнил чёрные остроносые ботфорты на широком каблуке,
красный кожаный корсет с воротником/кольцами, ремнями, задней шнуровкой,
наплечниками-крыльями и большие крылья с лёгким покачиванием при ходьбе.
`walking.gif`, `boots.gif`, `outfit.gif` показывают настоящий 3D-образец.
Ожидается согласование внешнего вида и движения перед подключением героине
и помощницам. Исходный `art/succubus/succubus_v02.glb` не менялся.
- В образце стопы перепривязаны: сустав поднят на 8 см в координатах модели,
исправлены inverse bind matrices и трансляции клипов; подошва жёсткая,
отдельно от каблука, не деформируется пальцами. Предварительная походка:
короче шаг, больше зазор между обувью, разворот опорной стопы ограничен 22°.
Крылья на существующих `Wing.L/R` покачиваются примерно на 2,3° с фазовой
задержкой и затухают при остановке. Сам образец воспроизводится скриптами
`tools/preview_succubus_heels.py`, `succubus_review_outfit.py`,
`review_mesh_cut.py`, `encode_succubus_review.py`.
- Проверки образца `reviews/heels_v01/review_tests.gd`: PASS, размеры героини
и помощницы, 4 скорости, 30/60 fps, поворот 90°, остановка, IK, высота стоп,
ограничение разворота и малая амплитуда крыльев. Максимальная ошибка IK
менее 0,000005 м. `--test-gait`: PASS для прежней основной походки, героини
и трёх помощниц на пяти скоростях, с поворотами, паузой, плетью и телепортом.
Общий `catwalk.gd` получил настраиваемые параметры и метод ориентации стопы
с прежними значениями по умолчанию; `succubus_actor.gd` — необязательную
подстановку PackedScene для отдельной review-сцены. Обычная игра использует
прежние настройки. Остаётся старое предупреждение LOD о вырожденной нормали.
- Туман после последних уточнений опущен ниже колен, ближе к полу:
`knee_fog.gdshader`, `density=.38675` (ещё -30% от `.5525`),
`surface_height=.45` м вместо `.78`. Объём по высоте уменьшен до `.9` м.
Широкие медленно дрейфующие пятна разрежены: пороги шума `.42–.76`,
множитель покрытия `.02–1.5`, больше открытого пола между клубами;
свечение следует пятнам и пропорционально плотности.
Крупные пятна и мелкие клубы движутся общим медленным потоком:
`drift_velocity=Vector2(.16,-.07)` м/с (около 17 см/с); мелкий шум слегка
меняет форму. Плотность и высота при добавлении дрейфа сохранены.
Есть движение мелких клубов, мягкая верхняя граница и расхождение вокруг ног
суккубы. Общий дальний фон остаётся слабым (`.0015`). Объём расширяется вместе
с комнатой. Плотность/высоту пользователь планирует отрегулировать после просмотра.
`--test-camera-controls` и `--test-room-decor` прошли; кадры с персонажами
и максимальным расширением проверены визуально.
- Из комнаты убраны декоративные столы, полки, трубы и мелкий реквизит.
Осталось шесть жаровен: четыре по углам, две у центров противоположных стен.
Симметрия, свет и огонь сохраняются на всех трёх расширениях.
- В пустой мастерской души не появляются. После установки первого орудия
начинается отсчёт пяти секунд. При отсутствии станков таймер стоит,
ворота закрыты, интерфейс предлагает установить первое орудие.
- По последней просьбе пользователя полностью удалена прокрутка камеры
при наведении мыши на края экрана. Следование за суккубой сохранено.
В строительстве работают WASD и средняя кнопка мыши.
- Реплики помещаются в компактное окошко одной строкой. Убраны принудительная
высота, перенос после имени и пустое место снизу; позиция учитывает размер окна.
## Важное поведение и исправления
- Каждой душе назначается ровно одно орудие. После его завершения душа сгорает:
скрытие на 1,7 секунде, удаление тела и эффекта на 2 секунде.
- `workshop.update()` должен вызывать `g.life.update(dt)` один раз за кадр,
вне цикла станков и условий видимости контекстного окна. Ошибка отступа здесь
уже замораживала сгорание и демонят. Для проверки нужен реальный игровой цикл,
а не только прямые вызовы обновления в тесте.
- Поднять орудие: удерживать ЛКМ одну секунду (есть круговой индикатор).
Затем мышь можно отпустить; следующий клик ставит орудие.
Наведение на нижнюю красную полосу продаёт его без клика.
Название и кнопка удаления при переносе не показываются.
- Сетка строительства содержит только полные метровые клетки.
Расширение сохраняет вид камеры и не ограничивает её старыми границами.
- В прокачке нет улучшений характеристик орудий. Уровни навыков отмечены
рубинами; изученные карточки сохраняют яркость. Текст карточек центрирован.
- Неоткрытые орудия в каталоге строительства затемнены.
- Модели суккубов используют `art/succubus/succubus_v02.glb`;
мужчины-души — `art/souls_v04`. Исходные варианты сохранены для переработки.
- Души плавно поворачиваются к носителю, следуют с левитацией и движением
опущенных рук; короткие лоскуты ткани колышутся в полёте.
- Походка демонят привязана к пройденному расстоянию с фиксацией опорной ноги.
Есть периодические занятия: уборка орудий, мытьё пола, рисунок и напевание.
- Реплики душ сейчас отключены (`dialogue.souls_enabled=false`).
## Проверки
Последние прогоны до первоначального переноса в Git:
| Проверка | Результат |
| --- | --- |
| `--test-camera-controls` | PASS после удаления краевой прокрутки и изменения реплик |
| `--test-economy` | PASS, 249 проверок, включая отсутствие душ до первой постройки |
| `--test-room-decor` | PASS, шесть жаровен и симметрия при всех расширениях |
До последних небольших правок также проходили проверки строительства,
расширений, рубинов, сгорания в реальном цикле, полёта душ и походки демонят.
Это не означает, что весь старый набор тестов повторно прогнан на текущем состоянии.
Часть старых сценариев может предполагать душу сразу после старта; теперь нужно
сначала установить орудие и дождаться спавна.
```powershell
& tools/godot/Godot_v4.3-stable_win64_console.exe --path Demon_v0.19 -- --test-camera-controls
& tools/godot/Godot_v4.3-stable_win64_console.exe --path Demon_v0.19 -- --test-economy
```
Графические проверки запускать с обычным рендерером. В `--headless` dummy renderer
выдаёт ошибки для этих моделей. Скриншоты и логи генерируются локально и игнорируются Git.
## Дальнейшая работа
Пользователь подтвердил 2026-10-28: дальнейшую разработку вести в клоне
`Diabolo/Demon_v0.19`, полученном из Git, и сохранять/отправлять все дальнейшие
изменения в репозиторий. Историческая папка `../Demon_v0.19` больше не является
рабочей версией на этом компьютере.
Клон получен с `origin/main` на коммите `3c488b5`; все 27 объектов LFS загружены.
Первичный импорт ресурсов завершён, повторный импорт Godot 4.3 прошёл без
ошибок. Игра запущена из клона с обычным рендерером Vulkan; стартовый лог без
ошибок. Игровой код при получении и запуске не менялся; полный набор тестов
повторно не запускался.
Постоянное правило пользователя: после каждой завершённой задачи коммитить
все изменения по задаче и отправлять в `origin`, обновляя этот handoff в том же
коммите. Повторное подтверждение обычного commit/push не требуется.
Правило для следующих сессий закреплено в `AGENTS.md`.
Обновлять этот файл в том же коммите, что и изменения: текущее состояние,
проверенные результаты, известные ограничения и незавершённая работа.
Подробная история предыдущих задач — `PROJECT_NOTES.md`.
Незавершённых игровых правок нет. Исходники опубликованы в `origin/main`:
первый коммит `2b9ae06`, 347 файлов. Успешно загружены все 27 объектов Git LFS
(539 МБ). Локальная ветка `main` отслеживает `origin/main`.
## Авторизация Git на этом компьютере
Для сервера настроен браузерный OAuth через Git Credential Manager и встроенное
приложение Gitea. Запрашивается `write:repository`; настройки находятся только
в локальном `.git/config`, секреты в исходники не добавляются.
Первая попытка без OAuth не прошла из-за отсутствия входа; после настройки OAuth
полный push исходников и LFS завершился успешно.
В терминале Codex доступен встроенный Git. Пользовательский PowerShell может
не видеть его в PATH. На текущем компьютере полный путь:
`C:\Users\JariKo\.cache\codex-runtimes\codex-primary-runtime\dependencies\native\git\cmd\git.exe`.
В PowerShell исполняемый файл по полному пути запускается через оператор `&`.