Files
Diabolo/HANDOFF.md
T

16 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.

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

  • Новый актуальный ориентир пользователя после красного комплекта: три вида суккубы (спереди, сзади и сбоку), чёрное бикини и броня/ботфорты на каблуках, длинный высокий чёрный хвост волос, длинные рога, низкие коричневые крылья с кожистой неровной перепонкой и тонкий шипастый хвост. Запрошены максимальная точность, реализм и качество текстур. У пользователя нет исходного 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, шесть жаровен и симметрия при всех расширениях

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

& 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 исполняемый файл по полному пути запускается через оператор &.