Files
Diabolo/HANDOFF.md
T

23 KiB
Raw Blame 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.

Последние выполненные задачи

  • Вступление (готово): новая смена запускает облёт главной героини. Через 2 секунды проигрывается целиком пользовательская запись Serafina (audio/intro_serafina.mp3, исходный ElevenLabs MP3 от 2026-10-28 18:59:40, 13,087 с). После сигнала AudioStreamPlayer.finished ещё 2 секунды камера плавно возвращается, затем включается HUD и управление. Симуляция и ввод во время сцены заблокированы; Idle героини продолжает работать. Громкость соответствует настройке голоса, фон приглушён. Потеря фокуса приостанавливает голос и камеру вместе. Продолжение из паузы без повтора. Код: intro_cinematic.gd, интеграция main.gd и cinematic_idle в succubus_actor.

  • Проверки вступления: импорт Godot 4.3 PASS; --test-intro PASS (полная запись, lead/tail, блокировка F5/B/T/Esc, неизменность денег/позиции, движение и возврат камеры, suspend/resume, отмена при reset, продолжение из паузы). После правки очистки при shutdown лог без SCRIPT ERROR. --test-camera-controls PASS. Кадр captures/intro-camera.png просмотрен: героиня в центре, HUD скрыт. Запускать «Новая игра»; существующий EXE не пересобирался.

  • Вступление коммитится отдельно от незавершённой переработки STL ниже. Вступление опубликовано в origin/main вместе с остальными накопившимися коммитами после исправления OAuth 2026-10-28 (см. раздел авторизации).

  • STL INFERNAL: согласован пользователем и включён в игру. Образец и включение в игру опубликованы в origin/main. Отправлены все пять накопившихся коммитов до 7f66396, в том числе вступление и прошлый образец. Успешно загружены все 8 новых LFS-объектов (254 МБ). reviews/infernal_v01/ содержит GLB, три карты 4K, GIF ходьбы/оборота/удара/лица, manifest, validation и отдельную сцену просмотра. По просьбе «добавляй и запусти» игровая копия включена в art/succubus/infernal_v01/infernal_game.glb; SHA256 совпадает с согласованным образцом. succubus_actor.gd использует её по умолчанию для героини и помощниц, с модельной меткой infernal_v01. infernal_gait.gd содержит согласованную походку, стопы, крылья и хвост; игровой код не зависит от сцен просмотра. Старые модели сохранены.

  • Сохранены пользовательские исходники tools/model_sources/infernal.stl (1 569 740 треугольников; байты сверены с infernal.zip), color_reference.png, SOURCES.json, редактируемый infernal_game.blend. Новая игровая сетка: 45 493 вершины / 90 801 треугольник, 166 костей; подставка удалена, подошвы закрыты. Печатные контакты рук и соединение ботинок разделены. Idle (73), Walk (33), Whip (65 кадров) перенесены со старого скелета, 24 fps.

  • Покраска: красная кожа, чёрный комплект, волосы, крылья, рога и хвост. По замечанию пользователя исправлено попадание чёрного цвета на открытую кожу: отдельный материал рук, непрерывные маски, уменьшены лучи запекания. По дополнительной просьбе пользователя контуры перерисованы по реальным швам скульпта: чашки, фигурный подол, воротник, ободки сапог. Присланная оранжевая обводка сохранена как tools/model_sources/approved_paint_boundary.png. Проекция по глубине отделяет ткань от руки за ней; скрытые складки получают окраску по соседней поверхности. Контуры — infernal_seams.py. Глаза/губы выровнены по скульпту; воротник заканчивается ниже подбородка. Плеть сохранена со старыми morph-анимациями, добавлен радиус шнура 8 мм.

  • У крыльев и хвоста лёгкое вторичное движение в покое и при ходьбе. Походка образца: короткий шаг, раздельные дорожки стоп, IK, ограничение разворота 22°. Результаты Godot: PASS, ошибка IK <0,000003 м; два масштаба, четыре скорости, 30/60 fps, поворот/остановка, мягкие движения крыльев и хвоста.

  • tools/validate_infernal.py PASS: три клипа с шагом 4 кадра, нормализованные веса, конечные координаты, отсутствие подставки, защищённый материал кожи, три карты 4096²; max edge growth Idle .00234 / Walk .03596 / Whip .06717 м. GIF сняты заново с окончательного GLB в Godot; дальнейшая правка должна повторять запись, а не использовать кадры от прежних вариантов.

  • Проверки включения в игровую сцену: импорт Godot 4.3 PASS, --test-gait PASS (героиня + три помощницы, пять скоростей, повороты, остановка, удары, пауза, телепорт). --test-intro PASS с новой героиней и полной записью. Кадр облёта просмотрен. Запускается актуальный проект, EXE не пересобирался.

  • Сборка: tools/build_infernal.py -- --bake, модули infernal_skinning/surface/ facepaint/bake/whip/seams.py. Локально finish_infernal.py повторяет покраску из checkpoint в captures. encode_infernal_review.py кодирует GIF. Полные команды в reviews/infernal_v01/README.md. Исходники STL/BLEND/GLB через LFS.

  • captures/.gdignore исключает технические большие BLEND и кадры из импорта. Перечисленные ниже модели красного комплекта и реконструкция по картинкам являются историческими вариантами; их заменил запрос на пользовательский STL.

  • Подготовлен образец на согласование, ещё не включённый в игровую сцену: Demon_v0.19/reviews/heels_v01. Пользователь запросил каблуки и исправление стоп при ходьбе, затем уточнил чёрные остроносые ботфорты на широком каблуке, красный кожаный корсет с воротником/кольцами, ремнями, задней шнуровкой, наплечниками-крыльями и большие крылья с лёгким покачиванием при ходьбе. walking.gif, boots.gif, outfit.gif показывают настоящий 3D-образец. Этот исторический образец заменён текущим STL; в игровую сцену не включён. Исходный 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, шесть жаровен и симметрия при всех расширениях

До последних небольших правок также проходили проверки строительства, расширений, рубинов, сгорания в реальном цикле, полёта душ и походки демонят. Это не означает, что весь старый набор тестов повторно прогнан на текущем состоянии. Часть старых сценариев может предполагать душу сразу после старта; теперь нужно сначала установить орудие и дождаться спавна.

& 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 на этом компьютере

2026-10-28 устранена повторявшаяся ошибка OAuth: a grant exists with different scope / Missing code in response. Существующий доступ Git Credential Manager был выдан с write:repository, а новый запрос отправлялся с пустым scope. Отзывать доступ и создавать токен не потребовалось; восстановлен прежний scope локально для этого checkout:

git config --local credential.https://gt.arcade.4bqb.com.oauthScopes write:repository

Не удалять эту настройку при дальнейшей работе. Она находится в .git/config, не содержит секрета и не расширяет прежние права. Вход использует существующее OAuth-приложение Git Credential Manager на том же сервере. Секреты в исходники и конфигурацию проекта не добавлялись.

После исправления git push origin main завершился успешно: удалённый main перешёл с 3c488b5 на 7f66396; все 8 LFS-объектов (254 МБ) загружены. Таким образом, модель, её включение в игру, вступление с записью и предыдущие локальные коммиты опубликованы. После этой записи выполняется отдельный коммит handoff и завершающий push.

В терминале Codex доступен встроенный Git. Пользовательский PowerShell может не видеть его в PATH. На этом компьютере полный путь: C:/Users/jaros/.cache/codex-runtimes/codex-primary-runtime/dependencies/native/git/cmd/git.exe. В PowerShell исполняемый файл по полному пути запускается через оператор &.