gameplay-testing
Skill3 starsChanged 52 days agoMITView on GitHub
Пишет и прогоняет headless-проверки игрового процесса Astral Genesis (генератор уровня, модель тела и распада) плюс ведёт чек-лист ручного плейтеста. Запускать при отладке игровой логики, после правок в GECS-системах, генераторе уровня, дверях/слотах, body-snatch/decay-модели или интеракции, когда нужно покрыть новый инвариант проверкой, и перед тем как считать задачу завершённой.
In this repository5 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- commit-messageSkill
- docs-syncSkill
- project-statusSkill
- shipSkill
The file
Files
Тестирование игрового процесса
Отладка игровой логики в этом проекте идёт через headless-прогон, а не через
клики в редакторе: у Godot есть консольная сборка
(Godot_v4.7.2-stable_win64_console.exe), сценарий в dev/ запускается
godot --headless <сцена> и выходит с ненулевым кодом при провале. Сторонних
тест-фреймворков (GUT, gdUnit) в проекте нет — проверка это обычная сцена Godot
со скриптом, который сам считает ассерты и зовёт get_tree().quit(код).
Скилл делает три вещи: прогоняет существующие проверки (§«Быстрый прогон»), пишет новые под новый инвариант (§«Как писать проверку») и держит чек-лист ручного плейтеста для того, что headless поймать не может.
Одно не заменяет другое: headless ловит регрессии в данных и структуре (граф несвязен, характеристика не перенеслась), но не в ощущениях (тело село в пол, дверь развернула камеру).
Быстрый прогон
.\dev\run_checks.ps1Тот же раннер гоняет CI (джоб «Headless-проверки» в .github/workflows/build.yml)
на каждом PR в master и на каждом пуше в master, поэтому он лежит в dev/, а не в папке
скилла. Godot он берёт из -GodotPath, из переменной окружения GODOT или из
PATH (на Linux/macOS — pwsh dev/run_checks.ps1).
Прогоняет любой dev/*_check.tscn, печатает по каждой OK/FAIL и общий
вердикт с кодом возврата (0 — всё прошло). Новый файл с суффиксом
_check.tscn подхватывается сам, регистрировать его в скрипте не нужно. Особых
случаев у раннера нет: последний, dev/gen_verifier, разбирался регулярками,
и два числа из четырёх раннер только печатал — его инварианты стали ассертами
corridor_graph_check. Параметры:
-Check <имя>— прогнать только одну проверку: имя файла без расширения (body_traits_check,stat_modifiers_check, …). Без-Check— всё сразу.-ListChecks— только напечатать, что сейчас найдено под-Check All, без запуска Godot. Полезно после того как вdev/появился новый сценарий.-GodotPath <путь>— если Godot не вC:\Program Files\Godot Engine\...по умолчанию (скрипт также сам ищет любой*_console.exeтам же, рекурсивно).-SkipSubmoduleCheck— не проверятьaddons/gecsперед прогоном.
Прогон беззвучен, и это сделано специально. --headless выключает
аудиодрайвер Godot, но byProd открывает своё устройство сам и про ключ движка не
знает — пока в AudioManager не появилась развилка, каждая проверка играла в
наушниках у того, кто её запустил. В headless рантайм поднимается без устройства
вывода (create_host_mixed), и byprod_check это сверяет. Признак в логе:
Audio started on null driver вместо on MiniAudio. Подробности — [[Звук]], §5а.
Скрипт сам чинит одну частую ловушку: в свежем git worktree addons/gecs
пустой (сабмодуль не инициализирован) — Godot всё равно рапортует --import
успешным, но Entity/Component/System/Observer не существуют и любой
headless-прогон молча ничего не проверяет. Скрипт вызывает
git submodule update --init addons/gecs, если сабмодуль пуст.
Что именно проверяется
dev/system_order_check.tscn— порядок систем в том виде, в каком его получает ИГРА: грузит настоящийworld.tscn, сортирует группы той же топосортировкой GECS, чтоWorld.initialize(), и сверяет: всё, что готовит перемещение (скорость, маска), идёт доS_Movement, лучи от камеры — после, плюс парныеdeps()(гравитация до прыжка, бег и ИИ до шага, детектор цели до захвата). Заодно раскладка: папка системы совпадает с её группой, наблюдатели лежат вsrc/observers/. Регресс на баг: сортировка по Кану уводилаS_Walk/S_JumpзаS_Movement, и ход с прыжком применялись на тик позже, а остальные проверки собирали системы списком и видели другой порядок. Проверено мутацией: безdeps()уS_Movementпадает ровно на них. Запускать после любой правкиdeps(), групп вworld.tscnили переноса файла системы.dev/presets_tool_check.tscn— вкладка «Редактор пресетов» на ВРЕМЕННОЙ библиотеке вuser://(правки пишутся на диск по-настоящему, и гонять их по данным проекта значило бы портить их каждым прогоном): загрузка и счётчик «В сцене», правка из карточки доезжает до файла и до строки таблицы, новый тег заводится в словаре и вешается, «убрать из словаря» не снимает тег с пресетов, проверка сцен разбирает двери. Главное — переименование тега в уже занятое имя: это слияние, запись в словаре остаётся одна, пустое описание берётся у старой. Мутация «переименовать id без слияния» даёт ровно прежний баг — две записиbeta. Откат Ctrl+Z headless не проверить (истории вне редактора нет); его путь проверялся зондом в живом редакторе. Запускать после правокaddons/game_design_tool/tabs/presets*,shared/undo.gd,shared/tags.gd.dev/body_traits_check.tscn— ассерты модели характеристик тела:E_Player.foot_offset()реально меряет коллайдер (не возвращает 0), характеристики читаются из сцены и переносятся при захвате с числами самого тела, карман распада тела тикает отдельно от запаса души, добровольный выход суммирует остаток, излишек утекает быстрее во столько раз, сколько велитlifespan_overflow_leak, гибель тела оставляетlifespan_death_fractionи снимает все трейты. Числа берутся из сцены тела иGameConfig, а не литералами: тюнинг баланса проверку не валит. Запускать после правок вS_BodySnatch,O_ExpelFromBody,S_Lifespan, любомC_BodyTrait.- Предупреждения
WARNING: N ObjectDB instances were leaked at exit/ERROR: N resources still in use at exitв конце прогона — фоновый шум выключения headless-процесса (тестовые сцены не освобождают всё за собой явно), не провал теста. Провал — это код возврата ≠ 0 и строкиFAILв выводе. - Итоговую строку
=== ИТОГ: ... ===проверка обязана напечатать сама, и раннер её требует.--quit-afterсчитает кадры ОТРИСОВКИ (в headless их в разы больше, чем физкадров:Engine.max_fpsтам не соблюдается), и упёршаяся в этот лимит проверка закрывается движком, не дойдя доget_tree().quit(), — то есть с кодом 0. По коду возврата обрыв неотличим от успеха, поэтому отсутствие итоговой строки раннер считает провалом.
- Предупреждения
dev/abilities_check.tscn— модель «возможность = компонент» на настоящемe_player.tscn: полёт и проход сквозь решётки души авторены в её сцене, засыпают во плоти и просыпаются при выходе (в том числе после пересадки тело→тело и после воплощения ВТОРЫМ путём — загрузкой сейва, без захвата); безногое тело не даёт ни прыжка, ни бега, и на попытку отвечает сообщением, а призраку — нет; бег кладёт множитель вC_StatModifiers, а не вC_Walk.speed, и снимается вместе с телом; прыжок с настоящего пола срабатывает после гравитации; под блокирующим экраном ввод отпускается; HUD показывает ровно то, что риг умеет сейчас. Проверка неявно пишет вuser://skills.tres: выход из тела, надетого в разделе 6 в обходon_worn(карман распада пуст), засчитывается «Чистым выходом» и начисляет очко. ПоэтомуSkillManager.saveна время прогона подменяется копией, а файл возвращается байт в байт, и последний ассерт это подтверждает. Запускать после правокO_SoulTraits,O_ExpelFromBody,S_BodySnatch, систем движения иUI_HudAbilities.dev/stat_modifiers_check.tscn— ассерты паттерна «база + модификаторы» (C_StatModifiers/RS_StatModifier): свёртка(base + Σflat) * Πmult, независимость от порядка источников, идемпотентность и снятие источника, изоляция модификаторов между сущностями, доезд дерева перков до души (ранг растит стат, база в компоненте цела, обнуление рангов возвращает базу — без сверки с числамиskill_tree.tres, их тюнят). Запускать после правок вO_ApplySkillEffects,SkillManager, любом стате из каталогаC_StatModifiers.dev/body_form_check.tscn— ассерты физической формы захваченного тела (C_BodyForm/O_BodyForm): контракт сцен тел (кореньE_Body, слойenemies, читаемые габарит и маркерEyes), перенос капсулы и посадка камеры на уровень глаз, откат к призрачной форме, отказ при нехватке места (синтетический блокер) — и отдельно, на настоящей геометрии трёх комнатных шаблонов (default_room/exit_room/lab_room), что штатно расставленное тело (подошва наy=0, как и пол комнаты) не считается «нет места» из-за простого касания пола. Регресс на баг, найденный живым прогоном:_fits()кастовал капсулу БЕЗ зазора, иintersect_shapeпротив пол-трисетки (ConcavePolygonShape3D) стабильно засчитывал касание подошвы с полом как пересечение — захват отклонялся в КАЖДОЙ заспавненной комнате («Тело здесь не поместится»), но не в хабе, где тела оказались случайно приподняты над локальным полом. Чинит_FLOOR_CLEARANCEвS_BodySnatch._fits(). Запускать после правок вS_BodySnatch, сценах тел,E_Player.foot_offset, либо в комнатных шаблонах (src/levels/procedural/rooms/), если меняется расстановка тел или геометрия пола.dev/enemy_ai_check.tscn— ассерты простого поведения врага (S_EnemyAI/C_EnemyAI): бестелесную душу враг не замечает вовсе (цель — только воплощённый БФЖ, у которого естьC_Health), внеaggro_rangeстоит на месте (в т.ч. физически, не только по флагу), в радиусе — разворачивается и реально идёт (сквозная проверка, чтоE_Enemy—CharacterBody3D, а неStaticBody3D, какE_Body— иначеS_Walk/S_Movementего не двигают), в упор бьёт с кулдауном (не каждый кадр), а добитое тело выбрасывает игрока обратно в призрака через уже отлаженныйO_ExpelFromBody. Враг замечает только то, что в конусе обзора, поэтому проверка разворачивает его к цели перед погоней, а бьёт после явной просьбы о проверке обзора (sight_left = 0). Первые два ассерта — регресс-проверка на баг, найденный живым прогоном: враг двигается черезC_EnemyInput, а НЕC_PlayerInput— второй такой компонент в мире ломает добрый десяток мест, которые находят «игрока» просто по наличиюC_PlayerInput(RunManager.travel_to,S_InteractionDetector, HUD), из-за чего переход через дверь и интеракция молча промахивались мимо настоящего игрока. Запускать после правок вS_EnemyAI,C_EnemyAI,E_Enemy,C_EnemyInput/C_PlayerInput, либо вC_Health/O_ExpelFromBody, если меняется контракт «кто и как наносит урон».- Ещё пять ассертов — слои коллизий (всего 17). Игрок стоит на
player, а не наstatic_colliders, враг — наenemies, а не наmoving_colliders. Маска врага видит стены, игрока, подвижную и проницаемую геометрию, маска игрока не видитenemies. И тело за спиной врага остаётся в прицеле захвата: мутация «S_SnatchTargetDetectorне проходит насквозь не-цели» валит этот ассерт. Запускать также после правок слоёв или масок в сценах игрока, врага и тел.
- Ещё пять ассертов — слои коллизий (всего 17). Игрок стоит на
dev/ragdoll_check.tscn— мышцы рэгдолла трупа (C_Ragdoll,S_Ragdoll, [[Захват тела]] §«Мышцы рэгдолла»): тело, лежащее с начала, стартует рэгдоллом из нейтральной позы (колени согнуты), колено при падении не выгибается назад, черезactive_secondsмышцы гаснут; свежий труп подхватывается посреди клипа гибели со скоростью костей из клипа, а удар бросает руки по удару и ноги навстречу. Сквозной путь удара до трупа (C_Struck→struck_from) держитcombat_check. Глазом — по кадрам: что тело легло «естественно», headless не скажет.dev/enemy_roster_check.tscn— ассерты ростера врагов по слоям и существа L5 (RS_EnemyRoster, маркерыEnemySpawn*,S_Attack.damage_against). Состав: на каждой глубине ростер отдаёт ровно положенных врагов (множества, не веса), часть маркеров пуста, но не все; бросок — функция входа (сид, слой, узел, маркер) и не трогает глобальный ГСЧ. На настоящемRunManager: слой, собранный заново, возвращает тех же врагов на те же маркеры, враги ростера зарегистрированы и несутC_BodyOriginс id маркера, на дне встают существа L5; труп убитого врага наследует id и лежит там, где враг умер, а не на маркере (сверяются кости рэгдолла, не корень: корень встаёт на место в любом случае, а рэгдолл, запущенный до установки трансформа, оставался в начале комнаты — мутация «трансформ после add_child» валит ассерт), съеденный труп снимает маркер при новой сборке слоя, а убитый и оставленный — возвращается (задокументированный пробел, ассерт на него фиксирует это). Сопротивление: удар тела класса ниже L5 (и души вне тела) по существу L5 ×L5_RESISTANCE, удар L5 и удар по не-L5 — полный урон; труп L5 —body_class5, класс угрозы врага читается из трупа. Маркеры сверяются по настоящей геометрии комнат из библиотеки: луч вниз находит пол у маркера, капсула существа L5 над ним не пересекает статику, а в выходе, у Архитектора и на лестнице маркеров нет. Проверено мутациями: множитель без ослабления валит три ассерта, маркер, поднятый в воздух, — ассерт про пол. Сейв разработчика снимается и возвращается. Запускать после правокRS_EnemyRoster,data/enemy_roster.tres,LayerStreamer._spawn_roster_enemies,O_EnemyDeath,S_Attack.damage_against, сцен врагов/трупов L5 и при добавлении маркера в сцену комнаты.dev/enemy_nav_check.tscn— навигация и обнаружение врага (S_EnemyAI,LayerNavigation, поля обзора/памяти/путиC_EnemyAI; карточка «Навигация и обнаружение врага»). Арена из настоящей коллизии наstatic_colliders, навмеш запекается тем жеLayerNavigation, что и в игре. Обзор: при одной и той же расстановке без стены враг игрока замечает, а за высокой стеной — нет (контроль нужен, чтобы «не заметил» значило «закрыла стена», а не «далеко»); конус — за спиной не замечает и луч не бросает, вплотную со спины замечает; лучей за две секунды погони порядка десятка, а не сто двадцать. Память: потеряв цель из виду, идёт на место последней встречи (а не к новому месту цели), стоитlinger_timeи сдаётся. Путь: игрок виден над низкой стенкой, но не достижим по прямой — без навмеша враг упирается в стенку, после запекания обходит её конец. Шаблоны навмеша: разбор геометрии у всех общий, у каждойe_enemy*.tscnшаблон изLayerNavigation.PROFILES, покрывающий её капсулу, и маска геометрии противcollision_maskврага; каждый шаблон кому-то нужен. Размеры: под балкой на 2.3 м навмеш обычного размера есть, крупного нет, у размеров разные карты, враг получает карту своего шаблона, послеclear()— никакой. Настоящий слой: спавн запекает навмеши, и карта отвечает под каждой комнатой; снос снимает регионы; запекание, перебитое сносом, региона не оставляет. Печатает замер запекания на арене и на слое. Проверено мутациями: луч без учёта попадания валит два ассерта обзора, путь без точек навмеша — два ассерта обхода, крупный шаблон высотой 2.0 — ассерт балки и покрытия капсулы L5. Ждать навмеш надо спросив карту (LayerNavigation.is_ready): номер итерации региона растёт раньше, чем карта начинает отвечать. Запускать после правокS_EnemyAI,C_EnemyAI,LayerNavigation, шаблоновdata/enemy_navmesh*.tres,LayerStreamer.spawn/despawnи капсул или масок сцен врагов.dev/movement_check.tscn— ассерты перешагивания порогов (S_Movement.STEP_HEIGHT): CharacterBody3D закатывается на препятствие нижеSTEP_HEIGHT(0.16 м) без прыжка, а настоящая стена выше него по-прежнему останавливает как обычно — новый манёвр не должен занижать чувствительность коллизий везде подряд. Регресс на баг, найденный живым прогоном: дверные пороги и кромки комнатной геометрии высотой в несколько сантиметров тормозили ходьбу как полноценная стена, и пройти получалось только прыжком. Порог теста взят 0.15 м не случайно — голыйmove_and_slide()и без правки перекатывает капсулу через препятствия примерно до 0.12–0.13 м просто своей формой, так что тест специально целится в сантиметры, которые закрывает именно правка. Пятый ассерт — на ВТОРОЙ баг, найденный тем же прогоном: упёршись в настоящую стену, иногда не получалось прыгнуть._try_step()при неудачной попытке (стена, не ступенька) звалmove_and_collide()последним — этот метод не обновляетis_on_floor()(толькоmove_and_slide()его считает), и флаг лгал «в воздухе» до конца кадра, хотя тело физически на земле;S_Jumpв следующем кадре молча отказывал. Чинит собственныйmove_and_slide()в конце_try_step()с принудительным маленьким толчком вниз (velocity=ZERO снап не считает вовсе) — и отдельная защита от обратного: этот довесок сам не должен сжирать прыжок, ЗАДАННЫЙ этим же кадром (vel.velocity.y > 0— манёвр в process() вовсе не запускается). Запускать после правок вS_Movement,S_Jump, либо если поменялась форма коллайдера тел (радиус капсулы меняет естественный «перекат» без правки).dev/architect_check.tscn— ассерты задела под Архитектора ([[Артефакт «Архитектор»]]). Прокачка: уArchitectManagerсвоё дерево и свой сейв, его улучшения крутят только статы мира (ArchitectStats) — стат души у Архитектора мёртвая строка, его никто не кладёт вC_StatModifiers, — каждый стат мира чем-то занят, ранги «Карты комплекса» дают уровни 1–4, лишний ранг в данных зажат до максимума, покупка не трогает очки навыков. Встреча (A_ArchitectEncounter): первое касание даёт эссенцию и открывает экран ИМЕННО Архитектора, повторное в том же забеге — ничего, отметка лежит в сейве забега, новый забег — новая награда, вне забега награды нет, а экран есть. Генерация по 30 сидам: Архитектор ровно один, только на глубинах 1, 2, 4 и на каждой из них побывал; одна дверь в коридор, без портала, не вход и не выход; все глубины вычеркнуты — конфиг невалиден. Сцена: одна дверь на юг, артефакт собран как интерактив, пол на пороге двери (иначе стык с тайлом — провал, как у B-комнат без коллизии). Сейвы забега, навыков и Архитектора подменяются и возвращаются. Проверено мутациями: награда без отметки валит 3 ассерта, Архитектор без вычеркнутого слоя хаба — ещё 3. Запускать после правокSkillProgression,ArchitectManager,A_ArchitectEncounter,data/architect_tree.tres, записи Архитектора вdata/world_gen_config.tres,RS_UniqueRoomи экрана дерева навыков.dev/essence_finds_check.tscn— ассерты находок и тайников эссенции (LayerFinds,E_EssenceFind, навык «Сбор эссенции»; [[Источники эссенции]]). Бросок — чистая функция сида, слоя и ключа: тот же вход даёт то же, другой сид и другой слой — иное, шанс 0 и 1 дают «никогда» и «везде», сумма не зависит от шанса. На настоящем забеге (шансы выставлены в 1, чтобы проверялось место, а не бросок): тайники стоят только вRS_LayerPlan.dead_endsи в каждом, находка — ровно на каждомEssenceSpot*комнат слоя, пересборка слоя кладёт то же. Взятие: начисляет номинал × доля черезaward_essenceпод своим источником (essence_pickup/essence_cache), пишет отметку, исчезает, повтор ничего не даёт, взятая не появляется при пересборке; навык доезжает до души и откатывается, касание Архитектора навык не множит. Сейвы забега, навыков и Архитектора снимаются байтами и возвращаются. Проверено мутациями: взятие без отметки валит три ассерта, доля мимоC_StatModifiers— ассерт про навык. Запускать после правокLayerFinds,E_EssenceFind,LayerStreamer(спавн/снос),RS_GameConfig(группа «Находки эссенции»), сцен комнат с маркерами, навыка вdata/skill_tree.tres.dev/complex_map_check.tscn— ассерты экрана карты комплекса и мини-карты ([[Экран карты комплекса]]). Правило видимостиMapKnowledgeна сгенерированном графе: уровень 0 не видит ничего, уровень 1 — не меньше мини-карты и по ВСЕМ этажам своего слоя, но без непосещённого за пределами соседей; 1–2 держат чужие слои закрытыми, 2 — свой слой целиком, 3 — все слои; портал узнаётся ровно у комнат с тегом портала. Экран (UI_ComplexMap) на том же графе без забега: полосы среза активны по уровню, полоса своего слоя — линия на этаж и штрих на каждую видимую комнату, игрок на своём этаже, чужие слои на уровне 2 закрыты и пусты, порталы в срезе — только между соседними слоями, панель на каждый этаж и каждый узел ровно в одной, обратная проекция курсора (node_at_point) под центром комнаты находит её саму, порталы помечены, второй конец межслойного портала на уровне 2 скрыт, на 3 — найден, и клик по нему открывает его слой с рамкой на нём; содержимое (имя уникальной комнаты, замок с именем ключа, значок типа) — только с уровня 4, а заглушки-буквы уникальных комнат разные. Настоящий забег: уровень 0 даёт строку «нет связи» вместо экрана, клавиша карты (на последнем ранге) открывает экран на паузе с маркером игрока, повторное открытие не плодит экран, та же клавиша закрывает и снимает паузу, поверх чужого экрана карта не открывается; терминал в хабе —C_Interactableбезrequires_body, объём наinteractives, подсветка находит меши егоVisual(пропSM_screen), касание открывает экран. Мини-карта (UI_MiniMap) на том же забеге, в настоящей сцене HUD: на уровне 0 Tab не открывает её, а даёт строку «нет связи»; на уровне 2 открывает без паузы и мимо стека экранов, текущий узел показан и прорисован раньше соседей, бусины коридора проступают по очереди и узел за коридором ждёт, пока до него дойдёт цепочка, новое вписывание перетекает, а узнанный при открытой карте узел прорисовывается с этого момента; заголовок на ранге 1 — только этаж, со второго — и слой, стрелки лестниц и порталов — с третьего; рамка обводит заголовок, план и подсказку и рвётся у края; подсказка — «[Tab] Свернуть», мышь не ловит; та же клавиша растворяет её, а не прячет сразу. Ниже последнего рангаMэкран не открывает, а отсылает к терминалу, и «[M] Вся карта» в подсказке нет; на последнем — есть, и полная карта сворачивает мини-карту; поверх экрана Tab её не трогает; терминал открывает экран уже на первом ранге. Плюс действияmapиmap_miniвInputMapиREBINDABLE_ACTIONSбез конфликта клавиш. Сейвы забега и Архитектора подменяются и возвращаются. Запускать после правокMapKnowledge,UI_MapFloor,UI_ComplexMap,UIManager.open_complex_mapи_toggle_mini_map,UI_MiniMap,ArchitectManager.map_level, терминала иhub.tscn, записейmap_name/map_iconв конфиге генерации и каталоге типов.dev/corridor_graph_check.tscn— ассерты генерации графа с коридорами ([[Процедурные коридоры между комнатами]]). Конфиг генерации и библиотека пресетов валидны (validate()). По 30 сидам: граф связен от входа, и по дверям и порталам доходишь туда же — обход так, как ходит игрок: из комнаты в коридор только через дверь, которую план поставил на этот коридор (RS_LayerPlan.door_faces), вертикальным ребром — только если в сцене есть портал (эти два инварианта раньше жили вdev/gen_verifierвне обвязки, и «недостижимо по дверям» раннер только печатал); вход — хаб, выходы — нужное число, на своей глубине, со своей сценой и тегом; у комнаты рёбер в коридоры ровно столько, сколько дверей в сцене (ребро без двери — недостижимый сосед, дверь без ребра — заваренная дверь), и ведут они в коридоры её этажа (в какие — решает раскладка, комната бывает на двух коридорах, см.corridor_layout_check); у каждого коридора есть сосед (коридор без дверей — законная перемычка или тупик); не больше одного вертикального ребра на узел, и портал в СЦЕНЕ (ищетсяE_VerticalPortal, а не тег пресета) ровно тогда, когда вертикальное ребро есть; каждая пара слоёв связана ОТКРЫТЫМ переходом, каждая пара этажей — переходом. Плюс детерминизм,HOME_DEPTH(умолчание тула) равен глубине хаба из конфига, уникальная комната с шансом 0 и 1 (роль будущего Архитектора), снимок ручек и версии генератора в сейве, а забег прежней версии сбрасывается на вход со свежим снимком и нетронутым запасом — сейв подменяется только в памяти. Проверено мутациями: не раздать лишние двери, снять гарантию открытого перехода, убрать сверку портала — каждая валит свой ассерт. Запускать после правокRS_LevelGraph,select_preset,RS_WorldGenConfig/RS_UniqueRoom,data/world_gen_config.tresи при добавлении пресета с порталом.- Здесь впервые поймали «тихо оборванный блок»: ошибка скрипта
(
SCRIPT ERROR) внутри блока обрывает только этот блок, итоговая строка печатается с нулём провалов, и первый прогон этой проверки прошёл зелёным на 6 ассертах из 23. Сначала от этого защищались ручным счётом ассертов; теперь это сторож общей обвязки (dev/check_harness.gd) для всех проверок.
- Здесь впервые поймали «тихо оборванный блок»: ошибка скрипта
(
dev/corridor_spawn_check.tscn— ассерты сборки коридоров в мире: настоящийRunManager. На каждый тайл плана — ровно один кусок кита, в клетке своей ветки; тупики слоя встали куском тупика и они есть (иначе лучи ниже тупика бы не видели); проёмы и стены сверяются ЛУЧАМИ по коллизии (слойstatic_colliders): в открытую сторону луч проходит, в закрытую упирается — только так ловится перевёрнутый поворот (RS_CorridorKit.rotate_mask). Прежний ассерт «кусок под маску» звал ту же формулу, на мутации «тупик с неверной базовой маской» зеленел и удалён; мутацию валят лучи. На стыке тайла с комнатой под ногами пол. Двери привязаны по сторонам плана, заваренных нет; межэтажный переход — порталом. Дверь в коридор открывается на месте: игрок и узел не меняются, подсветка гаснет, а проём освобождается по коллизии — луч сквозь дверь до открытия упирается в полотно, после — нет. По высоте узла это не проверить: прежний ассерт смотрел наVisualи зеленел, пока меш уезжал вверх, а коллизия полотна оставалась в проёме (мутация «поднимать Visual» его валит). Дверь хаба открывается на месте, как любая, шаг за неё — в его коридоре, и присутствие делает коридор текущим. Видимость слоя — у входа и после шага присутствием: показано ровно то, что вLayerStreamer.VISIBLE_HOPSрёбрах графа (ожидание — обход графа в самой проверке, видимость — по лампе комнаты и тайлам, а не по флагу стримера), враги спрятанных комнат видны. Мини-карта (UI_MiniMap.build_view): текущая ветка и хаб известны, комнаты на ветке видны соседями, маркер игрока внутри карты. Загрузка сейва в коридоре — на тайл той же ветки и по снимку ручек, даже если база ручек с тех пор изменилась. Сейв разработчика бэкапится. Запускать после правокRunManager(спавн тайлов,use_door, привязка дверей и порталов),RS_CorridorKit,data/corridor_kit.tres, сцен тайлов и дверей,mini_map.gd.dev/corridor_layout_check.tscn— ассерты коридорной РАСКЛАДКИ (RS_CorridorPlanner, сетью — п. 7 карточки «Сетка уровня», коридор на отрезок между развилками — карточка «Коридор — отдельный узел») — второй путь валидации: corridor_graph_check сверяет двери по сцене, а у коридора сцены нет, и без проверки по плану он просто выпал бы из проверок. Два прогона — 30 сидов на ручках по умолчанию и 10 на 8 комнатах на этаж: все трассы проложены; комнаты не делят клетку, тайлы не встают на комнаты; двери — ровно двери сцены или сокеты, коридоры — ровно рёбра графа; перед каждой дверью тайл её коридора с проёмом в комнату; проёмы взаимны и ни один не ведёт в пустоту; стык коридоров есть ровно там, где в графе ребро между ними (лишний стык — проход, которого в графе нет); тайлы коридора связны; коридор — путь без развилок внутри и на развилке не сворачивает; коридор без двери — перемычка или тупик; тайл с одним проёмом — ровно отмеченный тупик, и тупиков на этаже не больше ручки;node_atузнаёт и комнаты, и тайлы; обволакиваемых комнат (по поясу,RS_LayoutMetrics.wraps) не больше 1 %, сквозных — не меньше 25 %; комнаты на двух коридорах, петли по коридору и тупики есть. Плюс детерминизм «один сид — один граф и раскладка». Печатает метрики раскладки (RS_LayoutMetrics, с числом коридоров на этаж) и распределение кусков кита — смотреть на них при правкеTURN_COSTи ручек петель/тупиков. Проверено мутациями: не открыть проём в комнату, не открыть стык — каждая валит свои ассерты; раскладка без предохранителей от обволакивания проходит на 4 комнатах и валится на 8 (15 %); с 29.09 8 комнат — ручки по умолчанию, а второй прогон идёт на 12, потолке ручки; развилка, берущая в коридор двух любых соседей вместо прямых, валит форму коридора.dev/run_entry_check.tscn— ассерты входа в забег с генерацией в фоне (RunManager.enter_complex_async) и шторки загрузки (UI_LoadingScreen). Фоновый вход на том же сиде строит тот же мир и ставит в тот же узел, что синхронныйenter_complex(подпись графа, узла и заспавненного слоя; сортировка строкой —sort()надStringNameсравнивает адреса); кадры идут, пока строится граф; в рабочем потоке не инстанцировано ни одной сцены (RS_RoomLayout.off_main_thread_instances) — кэши сцен перед этим сбрасываются, иначе фону нечем промахнуться; душа одна; слой порциями (LayerStreamer.spawn_async) встаёт тем же, что синхронный_spawn_layer(комнаты на тех же местах, те же тайлы), за несколько кадров, а оборванный не объявляет слой загруженным; переход порталом на другой слой (RunManager.travel_through_portal) в обоих видах — затемнение и шторка: пока слой собирается, у души нетC_Velocityи контрольная точка не ставится, после — душа в целевом узле со скоростью, экран открыт (шторка ищется черезis: поиск по типу класс скрипта не узнаёт), слой тот же, что после мгновенногоtravel_to; вход, перебитый новым на другом сиде, возвращаетfalseи мир нового не трогает; шторка выше слоёв HUD и ниже отладочного оверлея (слои берутся из сцен),dismiss()её убирает. Проверено мутациями: лестница внеRS_LevelGraph.scene_paths, генерация в кадре, вход без номера (_entry_serial), спавн без порций, глубина, поставленная до обрыва, незамороженная душа, неснятая шторка и контрольная точка посреди перехода валят каждая свои ассерты. Смену сцены черезSceneLoaderпроверка не покрывает: она сменила бы саму проверку. Сейв забега подменяется и возвращается. Запускать после правокenter_complex*,RS_LevelGraph.scene_paths(и любого нового источника сцен в генерации), кэшейRS_RoomLayout,UI_LoadingScreenиmain.gd.dev/room_presence_check.tscn— ассерты «текущий узел меняется присутствием, а не дверью». На плане по 10 сидам: каждая точка комнаты — центр, угол, рост игрока, чуть ниже пола — находит свой узел черезRS_LayerPlan.node_at, этажом выше та же (x, z) — уже не он, пустота и провал — ничьи. Сквозной прогон настоящегоRunManagerсS_RoomPresence: игрок шагает из хаба на тайл его ветки, и узел меняет НЕ шаг, а следующий такт системы — ровно одинroom_changed, ветка в сейве текущая и посещённая; повторный такт тишина, пустота узел не трогает, возврат пешком возвращает узел, переход на другой слой меняет узел сразу. Что дверь в коридор никого не переносит, сверяетcorridor_spawn_check. Сейв разработчика бэкапится и возвращается, как вrun_stats_check. Запускать после правокtravel_to,note_presence,RS_LayerPlan(сетка, этажи).dev/world_gen_tool_check.tscn— ассерты по 30 сидам: слой редакторского тула «Генератор мира» (addons/game_design_tool/world/) строится по числу узлов графа (оверлеи «Геометрия» и «Граф» не оставляют геометрию прошлой раскладки, «Подписи» — не остаются видимыми БЕЗ выделения), а ray-vs-AABB пикинг (Picker) находит именно тот узел, в чью коробку послан луч. Всё в этой области ломается ТИХО — неверный пикинг, утёкшая геометрия предыдущей раскладки, обводка не на той комнате или подпись не с тем текстом/не в том месте не бросают ошибку, просто показывают не то, что нарисовано. Регресс на баг живого прогона: оверлеи чистили детейqueue_free(), а пересборка слоя синхронная (сид/глубина меняются в один тик) — отложенное удаление не успевало сработать между вызовамиshow_layer, и старая геометрия накапливалась поверх новой. Чинитfree()вместоqueue_free()вRoomsOverlay.clear()/GraphOverlay._clear_spheres(). Плюс: 9 ассертов на инлайн-редактор пресета в боковой панели (tabs/world_gen.gd, v3-стретч);LabelsOverlay.set_selected— подпись скрыта до выделения, при выделении показывает id/имя пресета и встаёт на +5 м от верхней граниPicker.room_aabb, прячется при сбросе;RoomsOverlay.set_selected—material_overlay(обводка, тот же приём, что у игровогоO_OutlineVisual/RS_EntityVisuals) ставится РОВНО на геометрию выбранной комнаты и снимается с прежней при переключении/сбросе. Всё — ТОЛЬКО чтение: узел с пресетом заполняет форму/подпись значениями ИЗ ресурса, узел без пресета (хаб — авторская сцена вне библиотеки) прячет секцию инлайн- редактора вместо пустой/чужой формы. Обработчики правки (_on_slot_changedи т.п.) не зовутся — пишут в реальные файлы проекта, та же дисциплина, что у кнопок Room Wizard. Плюс_check_restore_state—_restore_state()(реальный путь первого показа вкладки) вне редактора безопасно откатывается на дефолты сида/глубины/оверлеев и всё равно строит граф, а не падает наEditorSettings, которого в headless-прогоне нет (Engine.is_editor_hint()ложно, см.world_gen.gd._get_meta/_set_meta); само чтение/запись project metadata и живое сохранение позиции камеры headless не проверяются —EditorInterface.get_editor_settings()этот прогон не задевает, звать его некуда. Плюс на каждом из 30 сидов: хаб (RS_LevelGraph.HUB_ROOM_SCENE) — ровно один узел на весь граф, и это всегда гарантированный тупик (degree=1) — регресс-щит на риск того, чтоhub.tres(RS_RoomPresetLibrary.hub, у хаба тоже есть свой пресет теперь, см. [[Единый редактор геймдизайна]]) протечёт в пул автоподбора.presetsи молча достанется другим узлам-тупикам; и что боковая панель узнаёт хаб как обычный пресет (секция видима,_editing_preset == library.hub), а не прячет её, как раньше. Запускать после правок вRS_LayerPlan,RS_RoomLayout,RS_LevelGraph,RS_EntityVisuals,RS_RoomPresetLibrary, либо в самомaddons/game_design_tool/world/илиtabs/world_gen.gd(живую камеру, кликиMenuButton«Видимость» иEditorInterface-кнопки этот прогон не задевает — их некуда звать headless). Коридоры (_check_corridors): оверлей «Коридоры» рисует каждую ветку, «Геометрия» ставит по куску кита на тайл (тем жеRS_CorridorKit.instantiate, что игра) и после второй сборки подряд не оставляет тайлов первой — мутация «не освобождать тайлы в clear()» ассерт валит; выделенная ветка обводится всеми тайлами и снимается при сбросе; клик по тайлу выделяет ветку, по комнате — комнату. Сетка (_check_grid_overlay, 5 сидов, все слои): контур и стрелка поворота у каждой комнаты, дверных отметок ровно дверей плана, глухих — остальных сокетов, тупики и стыки веток по плану, пересборка не копит отрезки, выделение красит ровно контур и стрелку своей комнаты. Стрелка сверяется с поворотом корня (room_transform) — формулой, которой оверлей не пользуется; мутация «+turns вместо −turns» её валит. Прогон сидов (_check_seed_sweep): метрики раскладки совпадают с посчитанными по тем же сидам, а таблица «Где встретить» (в скольких сидах пресет выпал, по слоям) пересчитывается прямо по сидам без кода вкладки — общий с ней только формат строки; мутация «слою засчитывается два сида» её валит. «Забег из сейва» (_check_save_run, сейв синтетический и только в памяти): вкладка строит тот же граф, что игра на загрузке этого сейва (ручки — по правилуRunManager._run_gen_config), берёт слепок ручек, а не текущий конфиг (слепок нарочно с другим числом комнат), открывает слой игрока с его комнатой выделенной и показывает в поле сид забега; забег прежнего генератора — так, как его перестроит игра. Мутация «вкладка игнорирует слепок» валит два ассерта.dev/grid_view_check.tscn— ассерты узла сеткиGridViewи грани клетки во вложении (GridEmbedding.face_edge), без плана и без игры: грань — на полпути к соседу, длиной в клетку, поперёк; решётка 3×2 — 17 отрезков (общая грань один раз, без склейки было бы 24); контур — грани периметра; стрелка смотрит к соседу за своей стороной, стрелка грани — с её середины внутрь; отметки по цветам;commitсобирает один меш линий, пустой узел — без меша. Ломается это молча — схема просто рисует не то. Запускать после правокsrc/grid/grid_view.gdи вложений сетки.dev/room_wizard_check.tscn— ассерты: Room Wizard (addons/game_design_tool/dock/room_wizard.gd) на пяти реальных сценах комнат считает верный путь ресурса (соглашение имён —<сцена>.tresрядом со сценой) и строит рефлексивную форму РОВНО по скалярным@export-полямRS_RoomPreset(display_name/slot_count/weight) — безscene/tags(своя вёрстка) и без служебных полейResourceвродеresource_local_to_scene, которые тоже несутPROPERTY_USAGE_EDITORи просочились бы в форму при недостаточно строгом фильтре (PROPERTY_USAGE_SCRIPT_VARIABLE and PROPERTY_USAGE_EDITORвместе — только одногоEDITORмало). Клики по кнопкам «Сохранить»/«Добавить в библиотеку» не проверяются вовсе — они пишут в реальные файлы проекта (новый.tres, правкаroom_preset_library.tres), и гонять запись на каждый прогон было бы разрушительно, а не проверкой; их поведение — живой прогон в редакторе. Исключение —.disabled-СОСТОЯНИЕ кнопки «Добавить в библиотеку» на хабе (hub.tscn): это чтение, не запись, и оно ровно то, что защищает инвариант «хаб не в пуле автоподбора» (RS_RoomPresetLibrary.hub, не.presets) от случайного клика дизайнера — единственная сцена в наборе, где эта кнопка обязана быть выключена, хотя пресет уже существует на диске. Запускать после правок вRS_RoomPreset,room_wizard.gd,RS_RoomPresetLibrary, либо при переносе/переименовании сцен комнат (ломает соглашение имён, на которое Wizard опирается).dev/room_dressing_check.tscn— обстановка комнаты по сиду (RoomDressing,PlaceSetting,PropJitter; [[Расстановка пропов в комнатах]]) на столовой, 200 сидов. Тот же сид даёт ту же обстановку; другой сид или другой узел графа — иную. Правила подноса: напиток один (кружка или стакан), тарелка одна (плоская или плошка), чайная ложка только при кружке. Прибор не свисает со стола: углы бокса каждого предмета берутся в его собственных осях. AABB повёрнутого подноса шире самого подноса и давал ложный провал. Разнообразие встречается: пустые места, места с подносом и без, кружка и стакан, убранные стулья. Без этого правила зеленели бы и тогда, когда обстановка не срабатывает вовсе. Пути сцен кружки и тарелки берутся у сцены прибора, а не литералами. Проверено мутациями: чайная ложка без условия кружки и напиток, не снятый при замене, валят каждый свой ассерт. Зоны перед сокетами после обстановки сверяетroom_shell_check(п. 2, 200 сидов). Запускать после правокsrc/levels/dressing/,data/place_setting.tres,data/chair_jitter.tres, сцены прибора и расстановки столовой.dev/room_types_check.tscn— ассерты ВТОРОЙ оси подбора комнат (RS_RoomTypeCatalog,RS_RoomPreset.room_type,RS_LevelNode.room_type): каталог валиден и каждый его тип достижим хотя бы на одном слоеDEPTHS; выпавший тип всегда покрывает глубину узла, а на глубине без подходящих типов выпадает «без типа»; бросок тратит rng одинаково при любом исходе (rng один на всю генерацию — пропуск броска сдвинул бы всё, что разыгрывается после, и граф перестал бы быть функцией сида); тип — предпочтение, а не фильтр (тип без единого пресета не оставляет узел без комнаты) и при этом не пробивает фильтр портала, а лишний тег пресета не отнимает у него узел своего типа (специфичности, из-за которой так пропадалаlab_room, больше нет); после генерацииroom_typeузла равен типу ФАКТИЧЕСКИ вставшей комнаты, ключи типов не протекли вtags, а домашний узел подписан типом хаба (детерминизм типов сверяет подпись графа вcorridor_graph_check, она включаетroom_type). На ветке без коридоров (прежний генератор) ассерт «типизированные комнаты встречаются» не проходил — прежний подбор их вытеснял. Библиотека для части ассертов собирается прямо в проверке из настоящих сцен: поведение подбора нужно поставить в заранее известные условия, а на живой библиотеке они разъедутся при первой новой комнате. Запускать после правок вRS_RoomPresetLibrary,RS_LevelGraph, каталоге типов или при добавлении пресета сroom_type.- Проверка проверена мутациями: снятие предпочтения по типу валит 3 ассерта, отказ переписывать тип фактическим — ещё один. Держать её такой и дальше: оси тегов и типа разъезжаются молча, ошибкой это не выглядит никогда.
dev/outline_mask_check.tscn— ассерты обводки силуэтом (O_OutlineVisual+S_OutlineMask). Пикселей headless не рисует, поэтому проверяется ВХОД постэффекта, и ломается там всё тихо: ошибка в бите слоя, вcull_maskкамеры-двойника или в фоне её окружения не бросает ничего — просто вместо контура вокруг объекта выходит либо пустой экран, либо рамка по краю кадра. Слой: выделение переводит на слой обводки ВСЕ меши объекта (иначе силуэт дырявый), прочие слои меша не тронуты, снятие возвращает их ровно к прежним, аmaterial_overlayне трогается вовсе — регресс-щит на тихий возврат старого подхода с выдавленной геометрией. Сборка маски:cull_maskровно один бит, фон пустой а не небо (с небом маска залита целиком),mask_texподан в шейдер, материал оверлея — КОПИЯ, а не общий.tres(иначеViewportTextureпрогона утекает в файл проекта). Цена: без выделения маска вUPDATE_DISABLEDи оверлей скрыт — полноэкранный проход не должен крутиться вхолостую. Геометрия: камера-двойник совпала с игровой по трансформу и проекции, размер маски равен экрану (шейдер читает её поSCREEN_UV), ножницы накрывают проекцию объекта и заметно меньше экрана, объект за спиной обводки не даёт, а объект в упор обводится по всему экрану (unproject_positionтам врёт). Проверено мутациями: снятие ножниц валит ассерт про площадь, покраска только первого меша — ассерт про составной объект. Запускать после правок вO_OutlineVisual,S_OutlineMask,RS_EntityVisuals,outline_mask.gdshaderлибо при смене слоя обводки. Как контур ВЫГЛЯДИТ — только живой прогон.dev/room_tags_check.tscn— ассерты СЛОВАРЯ структурных тегов (RS_RoomTagCatalog,data/room_tag_catalog.tres): словарь назначен библиотеке и валиден (нет дублей и пустыхid); каждый тег, который носит хоть один пресет, в словаре есть и описан (тег без описания неотличим от опечатки — ради этого различия словарь и заводился, и только оно делаетverticalhubзаметным рядом сvertical_hub); флагset_by_generatorсовпадает с реальностью в обе стороны — каждый тег, которыйRS_LevelGraphза 12 сидов проставил узлам, помечен флагом, и каждый помеченный действительно выпадает. Вторая сверка не педантизм: по флагу инструмент выключает «Переименовать», и соврав в любую сторону, он либо блокирует безопасную правку, либо разрешает ту, что молча сломает подбор (ключи тегов в графе — строковые литералы). Обратного требования нет: тег в словаре, который пока никто не носит, — нормальное состояние (завели под ещё не нарисованную комнату). Запускать после правок в словаре,RS_LevelGraph(особенно если появился новый тег узла) или при добавлении пресета с новым тегом.dev/door_sound_check.tscn— звук хода двери (S_DoorMotion→C_DoorMotion.sound, [[Звук]] §3а) на обеих настоящих сценах дверей: старт открытия и старт закрытия поholdзаводят каждый своё событие хода (один и тот же путь), доехавший ход получаетstopи уходит рантайму (release_when_finished), развёрнутый посреди закрытия — ничего (удар в упор посреди проёма), а разворот заводит новое событие, которое доезжает соstop. Старт наблюдается поAudioManager.event_requested, окончание — записывающим объектом, положенным вC_DoorMotion.soundпосле старта: проверка не зависит ни от рантайма byProd, ни от собранного проекта звука. Числа хода — из компонента, не литералами. Проверено мутацией: без окончания на закрытии падают два ассерта. Запускать после правокS_DoorMotion,C_DoorMotionи сцен дверей.dev/vitals_sound_check.tscn— звуки модели тела ([[Звук]] §3б): удавшийся захват проситC_BodySnatch.capture_eventровно раз, неудавшийся — молчит; петля распада над порогом дуги (UI_HudMood.LOW) не заводится, ниже — заводится ровно раз, а не каждый кадр, ближе к нулю еёIntensityвыше и не выходит заintensity_max, над порогом она гаснет заfade_outи отдаётся рантайму, а не обрываетсяstop(). Проступание (fade_in) не проверяется: оно зовётся на инстансе в момент создания, до подмены. Запрос звука — поAudioManager.event_requested, петля после старта подменена записывающим объектом: от рантайма и собранного звука проверка не зависит. Порог — у дуги, не литералом. Проверено мутацией: без звука захвата падает ассерт захвата. Запускать после правокS_BodySnatch,S_DecaySound,C_DecaySound,UI_HudMood.read_vitals/decayи сцены игрока.dev/footsteps_check.tscn— ассерты озвучивания ходьбы (S_Footsteps/C_Footsteps). Разовый звук (PER_STEP): идущее по земле тело просит звук, путь меряется ПУТЁМ а не временем (число шагов отвечает пройденным метрам, на удвоенной скорости шагов заметно больше), стоящий и висящий в воздухе молчат, событие берётся из компонента, а сущность безC_Footstepsв выборку не попадает. Петля (LOOP): на весь отрезок ходьбы ровно одна просьба сыграть, а не одна на шаг — зацикленное событие не кончается само, и «на каждый шаг» копило бы инстансы, пока не кончатся голоса; остановка снимает петлю и не просит звук заново, следующий отрезок заводит её снова. Наблюдается сигналAudioManager.event_requested— он шлётся ДО проверки на загруженный проект byProd, поэтому проверка работает и без звукового контента. Тело — настоящийE_Enemyна настоящем полу с цепочкой S_Gravity → S_Movement:is_on_floor()считает толькоmove_and_slide(), и на синтетической сущности без пола он всегда ложь — проверка молча мерила бы пустоту. Запускать после правок вS_Footsteps,C_Footsteps,AudioManager, либо если менялась скорость/стоп хода (S_Walk,C_Walk) — частота шагов следует фактической скорости.dev/byprod_check.tscn— ассерты подключения аудиодвижка byProd (GDExtensionaddons/byprod): пять классов расширения зарегистрированы, менеджер создаётся, версия рантайма совпадает с той, под которую написан биндинг, запрос несуществующего события даётnull, такт и слушатель безопасны, а событие шагов (event:/sfx/walk) находится, заводится и переходит вSTATE_PLAYING. Последнее проверяется именно так, а не по флагу «проект загружен»: банки рантайм просит у хоста сам, и промах по каталогу выглядит снаружи ровно как «нет такого события». Отдельно — что прогон не открывает устройство вывода:--headlessглушит аудиодрайвер Godot, но не byProd, и без развилки вAudioManagerпроверки звучат в наушниках у того, кто их запустил. Ассерт честно слабый — спросить у рантайма «открыто ли устройство» нечем, поэтому сверяется решениеAudioManager; ловит он ровно убранную развилку, после которой звук вернулся бы молча. Отдельный ассерт сверяет проект с МЕХАНИКОЙ: событие, которое просит карточка навыка (UI_SkillNode.unlock_event,@export-строка), в собранном проекте есть. Спрашивается строка с карточки, а не литерал рядом — сверка константы с самой собой зеленела бы всегда; расходятся здесь именно проект и то, что просит код, и расходятся молча: byProd один раз предупредит в лог, а экран станет беззвучным. Ровно так этот путь и жил, пока события в проекте не было. Отдельным блоком — громкость: значение из настроек доезжает до мастер-шины, ноль доезжает как ноль (а не теряется по дороге), значение вне диапазона прижимается к единице. Правится оно черезSettingsManager.settingsцеликом, потому что проверяется вся цепочка «настройки → сигнал → движок», а не вызов в обход неё; исходные настройки проверка возвращает на место. Запускать после обновления расширения из godot-byprod, замены SDK, пересборки проекта звука в редакторе byProd, правок громкости (RS_Settings.master_volume,AudioManager._apply_volume) или паузы (AudioManager._apply_tick_level,_follow_pause).- Пауза (3 ассерта): биндинг умеет
set_auto_pause— единственный ассерт про паузу, который проходит и без рантайма, и ровно он ловит отставший аддон вaddons/byprod/bin/; а на живом рантайме инстанс, выданныйAudioManager, уходит на паузе игры вSTATE_PAUSEDи возвращается вSTATE_PLAYINGпосле. Второе проверяется наблюдаемым состоянием голоса, а не вызовами, потому что ломается это тихо во все три стороны сразу (неподписанный инстанс, автолоад безPROCESS_MODE_ALWAYS, уровень тика, не вернувшийся к FULL) и выглядит одинаково — «звук ведёт себя не так», без ошибки в логе. Мутациями проверено: снятие подписки и возврат автолоада вPAUSABLEвалят ассерт каждый по отдельности. Инстанс берётся уAudioManager, а не у описания напрямую: подписка ставится там, и мимо неё проверялся бы путь, которым механика звук не заводит. - Нативный рантайм (
byProd.dll/libbyProd.so) в репозитории не лежит — лицензия Madrigal разрешает распространять его только внутри собранной игры. Его отсутствие не провал: проверка это печатает и переключается на ветку «деградация в no-op» (10 ассертов вместо 21). Провал — если без рантайма что-то падает илиget_last_error()молчит. - В свежем клоне/worktree проверка провалится, пока не выполнен импорт
(
bash dev/import.sh— в облачной сессии его уже сделал SessionStart-хук; голыйgodot --headless --path . --importв headless виснет на многопоточном импорте, см. [[Релизы и сборка]]): список расширений лежит в.godot/extension_list.cfg, который в git не входит, а обычный запуск сцены его не создаёт — классов просто не существует. Та же ловушка по духу, что и с пустымaddons/gecs. - Ни один класс расширения не назван в скрипте идентификатором, только строкой
через
ClassDB: иначе при незагруженном расширении скрипт не прошёл бы парсер,_ready()не запустился бы, и прогон завершился бы с нулём, пропустив ровно ту поломку, ради которой написан. - Менеджер берётся у
AudioManager, свой заводить нельзя: второйByProdSoundManagerв одном процессе роняет рантайм segfault'ом прямо в создании, когда устройство уже открыто первым. Проверка, создававшая собственный, валила прогон кодом 139 — при том, что все её ассерты успевали напечататься зелёными, и в выводе поломка выглядела как чужая.
- Пауза (3 ассерта): биндинг умеет
dev/brightness_calibration_check.tscn— ассерты экрана калибровки яркости (UI_BrightnessCalibration, [[Калибровка яркости]]). Пикселей headless не рисует, и калибровка ломается молча — экран спокойно подбирает яркость не для того мира. Поэтому сверяется, из чего складывается картинка знаков: та же кривая подъёма теней (adjustment_color_correction) и тот же тонмаппинг при той же яркости, что у окруженияworld.tscn(берётся егоSceneState, а не литерал), свет эталонного слоя (L4) — серый той же яркости, чистый чёрный фон, знаки идут по тьме («виден» → «едва виден» → «не виден»), а ступень «Ультра» не добавляет знакам ни SSAO, ни SDFGI, ни тумана. Ползунок светлит знаки и не применяет яркость мимо «Готово». Потоки: из настроек — экран с яркостью черновика, «Назад» черновик не трогает, «Готово» кладёт значение в ползунок «Яркости» и зажигает «Применить», не трогая применённое; первый запуск — главное меню само открывает экран, «Готово» применяет и сохраняет, «Назад» тоже ставит отметкуbrightness_calibrated, откалиброванному экран не предлагается. Что подъём теней светлит фоновый свет, аexposure_multiplierкамеры нет, headless не видно — это замер живым рендером (карточка). Проверено мутациями: знак безpreview_brightnessи меню без предложения/отметки валят каждый свои ассерты.user://settings.tresснимается и возвращается байт в байт. Запускать после правок экрана,LevelEnvironment, окружения мира,data/depth_lighting.tres, главного меню и меню настроек.dev/settings_menu_check.tscn— ассерты вкладочного меню настроек (src/ui/settings_menu): состав и порядок вкладок, открыта первая, каждая настройка на своей вкладке и ни одна не задвоена. Проверка нужна ровно потому, что меню собирает контролы рекурсивным обходом поддерева, а не по путям: настройка, потерянная или вынесенная мимо вкладок при переверстке, не даёт ни ошибки, ни предупреждения — она просто перестаёт быть в меню. Отдельно два тихих инварианта раскладки: значения читаются и со скрытых вкладок (иначе baseline снимался бы неполным и «Применить» горела бы сразу при открытии — это и проверяется по кнопке), и минимумTabContainerне равен минимуму самой длинной страницы (ScrollContainerвнутри вкладки рвёт эту связь, иначе «Управление» с раскладкой клавиш растягивала бы окно и на «Аудио» с одним ползунком). Меню инстанцируется напрямую, безUIManager; настройки игрока не трогаются — правится только черновик, «Применить» не нажимается. Запускать после любой переверстки меню настроек, добавления настройки вRS_Settingsс контролом и правокsettings_menu.gd/src/ui/settings/*. Чего проверка не видит: как это выглядит — стили живут вassets/ui/default_theme.tres, эхо и штрих рисуютUI_EchoButton/UI_SettingRow, и headless их не рисует. Зато видит поведение: кнопки-вкладки листают страницы в своём порядке, списки теней и эффектов строятся из каталога, пресет раскатывает и ступень эффектов, строка наполняет колонку подсказки. Окружение уровня (LevelEnvironment) на синтетическомWorldEnvironment: яркость ставит кривую подъёма теней, которая поднимает почти-чёрное и не трогает ни чёрного, ни белого, ни освещённого лампой выше колена (регресс на гамму всего кадра, пересветившую комнаты), ступень эффектов и флажок свечения не включают того, что автор не ставил (SDFGI автора — только на «Ультра», не на «Высоких»), и считаются от авторского, а не от прошлой ступени, общий.tresне задевается, окружение сapply_brightness = falseкривой не ставит, туман по глубине кончается там, где лампы погасли, и идёт за ступенью теней. И поSceneStateвсех сценsrc/: каждыйWorldEnvironment— подLevelEnvironment, окружений наCamera3Dнет. Лампа гаснет на дальности теней ступени (при «Выкл» — наunshadowed_light_distance), спрятанная лампа тень у видимой не отнимает (ShadowBudget), ниже 100 % разрешения включён FSR1, поле зрения из настроек доходит до камеры игрока (по горизонтали,E_Player._apply_fov— до 08.10 его никто не читал). Запускать также после правокE_Player,LevelEnvironment,LevelLight,ShadowBudget,SettingsManager._apply_graphics_settingsиdata/graphics_presets.tres.dev/skill_graph_check.tscn— ассерты дерева навыков БЕЗ единогоControl: радиальная раскладкаSkillGraphLayout(место у каждого навыка, нейроны не налезают друг на друга, требование ближе к ядру, чем зависимый, нейрон в секторе своей ветки, секторы в порядкеordered_branch_ids),graph_rowкак слот по дуге, ветка по сумме рангов дальше от ядра, кольцо требований и обе развилки видимости —is_revealed(«навык можно брать») иis_previewed(«шаг вперёд пунктиром»). Запускать после правокSkillManager, раскладки сети иdata/skill_tree.tres.dev/skill_card_check.tscn— ассерты экрана навыков вокруг карточки справа: карточка не уходит за низ экрана и не шире колонки на каждом навыке боевого дерева, по-русски и по-английски (длинная причина на кнопке — «Сначала выполните требования» — уже раз распирала колонку; кнопка поэтому сдвинута на 26 px влево, как в спеке); кнопка называет ту причину, что есть (освоено / требования / нет очков), а не первую попавшуюся; вкладка Архитектора не видна до встречи с ним и видна после — в том числе у инкубатора; эссенция с тысячи — «12,4 тыс.»; старый сейв с рангами Архитектора считается встречей. Покупку не зовёт — сейвы подменены и не пишутся. Запускать после правокUI_SkillCard,SkillTreeUI, текстов навыков и при добавлении навыка с длинным описанием.dev/skill_layers_check.tscn— ассерты слоёв нейросети на боевом дереве и на синтетическом с заведомо пустой веткой: подпись ветки видна ровно там, где у ветки есть показанные нейроны, берётся из данных и не накрывает нейроны; синапс есть на каждое показанное требованиеSKILL_RANKи на каждый корень (от ядра) — ни одного лишнего; синапс упирается в края нейронов, а не в центры; синапсы лежат под нейронами (своегоz_indexнет, держит порядок в полотне). Запускать после правокUI_SkillSynapse,UI_SkillGraphи подписей веток.dev/skill_economy_check.tscn— ассерты экономики очков: порог 50% выжатости тела для «Чистого выхода», покрытие каталога статов навыками,validate()обоих деревьев и сброс дерева на «Новую игру» (включая то, что покупка навыка не пишет в дефолтный сейв —duplicate()не копируетDictionary). Реально зовётadd_skill_points/unlock, то есть ПИШЕТ на диск, поэтому оригинальныйSkillManager.saveвозвращается и пересохраняется в конце.dev/debug_overlay_check.tscn— ассерты отладочного оверлея (dev/debug_overlay.gd, читы для живого прогона — см. [[Отладочный оверлей]]): путь оверлея вmain.gdведёт на существующую сцену (опечатка не даёт ни ошибки, ни предупреждения —ResourceLoader.exists()вернётfalse, и читов просто не будет), каждый пресет экспорта исключаетdev/*— единственное, что держит читы вне собранной игры, а фильтр правится в диалоге экспорта одним кликом; шпаргалка на экране соответствует таблице читов (строка на каждый, ни одной пустой); клавиши не повторяются и не пересекаются сInputMap(до второй записи на ту же клавишу перебор не доходит, и чит выглядит «не работает»; этот ассерт сразу и нашёл F5, занятый встроеннымui_filedialog_refresh); «слой ниже» ведёт вглубь — сверка идёт с самимRS_LevelGraph, а не с числом в проверке; бессмертие держит полными ОБА кармана распада, и перед этим отдельный ассерт требует, чтобы без чита карман убывал — иначе «не убыло» было бы правдой зря и проверка зеленела бы на сломанномS_Lifespan. Клавиши не подставляются в обход обработчика: синтезируетсяInputEventKeyи зовётся_unhandled_key_input, то есть проходится тот же путь, что при живом нажатии. СейвыSkillManagerиArchitectManagerподменяются и возвращаются на место — начисление очков и эссенции ПИШЕТ вuser://. Четыре ассерта — раздел «Прокачка» меню отладки: кнопка на каждую запись таблицы начислений оверлея с её подписью, очки ложатся толькоSkillManager, эссенция толькоArchitectManager(валюта в чужом дереве не падает — экран Архитектора просто пуст), меню после начисления не закрывается. Семь — меню отладки (dev/debug_menu.tscn, клавиша`) и его «Телепорт»: меню открывается через стекUIManagerи не открывается дважды, кнопка на каждую записьunique_rooms, поиск поroom_scene_pathна пяти настоящих сидах (мутация «искать по другой строке» его валит), круг по комнатам одной сцены, кнопка без забега. Четыре — сид забега: в строке оверлея сид графа (RS_LevelGraph.run_seed, а вне забега —RS_WorldSave.run_seed()), а не сид мира, и без обрезки (сид за пределами int32), кнопка меню называет его же и кладёт в буфер (в headless буфера нет — сверяется сообщение оверлея); мутация «показывать world_seed» валит все четыре. Пересечение сInputMapне засчитывает действия с модификатором (Ctrl+`уui_swap_input_direction): голая клавиша их не вызывает, мутация «чит на F5» по-прежнему ловится. Самtravel_toздесь не зовётся — ему нужен живой мир. Запускать после правок таблицы читов и начислений, меню,main.gd, фильтров экспорта иunique_roomsв конфиге генерации.dev/body_look_check.tscn— варианты облика (C_Look, шесть обликов и двое очков учёного): розыгрыш по месту детерминирован, разные сиды дают разные лица, глобальный ГСЧ не тронут; облик на всей геометрии тела с растворением, виден ровно один вариант очков; при захвате номера и облик уезжают на душу и риг; контрольная точкаRunManagerпишет номера в сейв, а_restore_embodimentвозвращает тот же облик; труп врага носит облик врага;visual_of_sceneс номерами и без. Мутации «розыгрыш случайным ГСЧ» и «риг не переносит видимость» валят по ассерту. Разыгрыш на спавне слоя и пересборку держитdev/enemy_roster_check(три ассерта облика). Запускать после правокC_Look,RS_EntityVisuals.roll_look/dress,O_BodyVisual,O_EnemyDeath, сейва тела, сцен учёного.dev/polygon_check.tscn— полигон ([[Полигон]]) на настоящей сценеdev/polygon/polygon.tscn: системы и наблюдатели те же, что уworld.tscn(сравниваются узлы сцены, добавленные на ходу — слушатель HUD — нет), забег не начат; стенд клипов ведёт время сам — перемотка двигает позу костей, пауза её держит, кадр вперёд ровноAnimation.step, петля и её отсутствие; клип без петли после конца пускается заново и перематывается (плеер, доиграв его, сам останавливается, и стенд, ждавший «играет», замирал — мутация «опора наcurrent_animation» валит два ассерта). Версии клипов: имя файла относит её к самой длинной основной, синтетическая версия (run ← walk, в памяти, без файла) на стенде даёт позу walk, A/B на той же позиции — основную; общая подмена встаёт манекену и новому дереву, но не стенду, «основные» её снимают. Дорожка: манекен безC_EnemyInputсC_EnemyAI, каждая скорость изpresets()даёт свой клип, манекен держит круг, укус/попадание/прыжок видны в дереве, прочность после попадания возвращается, гибель настоящим путём (S_Health→O_EnemyDeath) — труп вdeath. Мат: захват с первого раза, тело поглощено и кладётся новое. Экраны забирают и отдают кадр и ввод; раздел «Полигон» меню отладки есть только в полигоне, кнопка станции переносит. Станция камеры от третьего лица — на игровой камере (C_ThirdPersonCamera,S_ThirdPersonCamera,S_CameraAim; карточка «Вид от третьего лица»):- кадр ведёт камера от третьего лица, интерполяция физики включена;
- у стены коридора плечо короче и камера не за стеной;
- маска плеча повторяет маску формы: душа с фазированием проходит решётку вместе с камерой, во плоти hound упирается;
- голова и руки облика в кадре;
- облик, манекен и решётка гаснут копиями материалов, общие не тронуты;
- опора маленькой души не у пола;
- два луча прицела (
S_CameraAim+AimRay): дальность интерактива — от тела, стена между глазами и целью обрывает луч; - у решётки полёт вперёд идёт горизонтально (полёт — по взгляду, а не по направлению от глаз к прицелу);
- слушатель звука у глаз персонажа и повёрнут как камера, а на экранах стенда
стоит у камеры облёта (
AudioManager.listener_pose(); мутация «уши в камере» валит ассерт); - мышь крутит камеру, а не тело; «вперёд» — куда смотрит камера; душа
разворачивается по направлению передвижения, а на захвате сразу встаёт к
прицелу (
S_BodyTurn, мутация «полёт по рысканию тела» валит два ассерта); - стрейф тела hound: шагом вбок тело держит взгляд камеры, идёт со скоростью
C_Walk.side_speed_scaleсмесью клипов кstrafe_right, а бег разворачивает его по передвижению (мутации «тело не держит взгляд» и «доля скорости не применяется» валят три ассерта).
Проверено мутациями: постоянная маска геометрии валит ассерт решётки (на прототипе), полёт по базису камеры в глазах — ассерт полёта, второй луч из камеры — ассерт дальности, маска интерактива без стен — ассерт стены (для него плечо прямо за телом: со сдвигом луч уходил мимо цели и без стены). Запускать и после правок систем камеры и лучей (
S_CameraAim,AimRay, детекторы,S_Attack),S_SoulCloud,PlayerPlacement. Уход со сцены сбрасываетEngine.time_scale, интерполяцию физики и подмену. Ассерт гибели нашёл баг с первого прогона: без нулевого шага дерева вe_body_rigged.gd._fallтруп стоял вidle, мутация «убратьadvance(0)» его валит. Сейв навыков снимается и возвращается. Запускать после правокdev/polygon/,S_BodyAnimation,O_BodyVisual,O_EnemyDeath,S_Phasing, сцен hound и игрока, тайлов коридора, меню отладки иmain.gd.dev/hud_check.tscn— ассерты HUD «Отголосок» без пикселей ([[HUD — спека]]). Кривые эффектов экрана (UI_HudScreenFx.update_params) сверяются с таблицами спеки по каждой строке: стабильность души, распад тела (без базы, в сепию, стабильность души не протекает в тон тела), кровь по HP — опечатка в пороге не роняет ничего, экран просто давит не тогда. Удар и волна вселения — импульсы, которые гаснут; цвет волны — нового кармана; красная вспышка растёт с долей урона (царапина — слабо, но не ноль); каждый удар кладёт новую раскладку пятен крови и перетекает в неё с прежней, а не рывком. Дуга (UI_DecayArc): ровное убывание её гасит, скачок на 0.05 за полсекунды зажигает, пороги 35 % и 15 %, излишек держит видимой, во плоти она показывает карман тела даже при пустой душе. Смятение T от числа тел вRunStats. Сообщение: таймлайн и равенствоC_ScreenMessage.remainingего длине, перенос после 720 px, резкость посередине показа и размытие на растворении. Подсказка — «[клавиша] действие», тень шире строки. Имена кнопок мыши и пробела — ключами. В сцене HUD нет ни одной подложки и полосы, эффекты экрана лежат ниже обводки, вариацииHud*темы (иHudMap*мини-карты) — на Golos; перо мини-карты (UI_MiniMap._partial) обрывает контур по доле длины пути, а не по доле точек. Время проверка подаёт сама (update_state/update_paramsпринимаютt), кадры движка не нужны. Раздел HUD вabilities_check— строки управления на смене тела и сообщение отказа на настоящем мире. Запускать после правокsrc/ui/hud/, темы,C_ScreenMessageи подсказок дверей вLayerStreamer.dev/version_label_check.tscn— ассерты: номер сборки виден там, где его ищут по скриншоту бага, — в углу главного меню и в строке состояния отладочного оверлея — и это ровноapplication/config/version. На время прогона подставляется номер не-релизной сборки0.7.0-dev.33+fc91d3c, а не тот, что вproject.godot: показывать надо именно его, с+и точками как есть ([[Релизы и сборка]], «Номер сборки»). Оверлею нужно два кадра:process_frameприходит раньше_processузлов, и после одного ожидания в строке ещё «—». Запускать после правок главного меню и строки состояния оверлея.dev/menu_scene_check.tscn— ассерты живой сцены за главным меню (L_menu_map.tscn, [[Меню — спека]] §8). Сцена грузится и крутится 90 кадров без единой ошибки движка — у проверки свой логгер на все ошибки, а не только на SCRIPT ERROR обвязки: битый путь узла или ресурса в сцене, которую игрок видит первой, — тоже провал. Время сцене и колбе (Incubator/Flask,IncubatorFlask) проверка подаёт сама (свой_processу них выключен): свечение колбы за 120 с не выходит за ±15 %, гуляет хотя бы на 10 % и жидкость стекла светится в такт со светом; лампа за 90 с больше мертва, чем горит, вспышек заметно больше, чем пауз, и паузы разные. Настоящая модель: объём колбы — по её стеклу, мозг и пузырьки — на её пустышкахBodyAnchor/BubbleSource, пузырьки непрозрачны (прозрачные стекло с преломлением прячет при любом порядке), и самый быстрый из них гаснет у крышки колбы, а не над ней; жидкость не толще диаметра колбы. Без арта (стекло и метки с модели сняты): запасная колба без жидкости, свет в её середине, мозг и пузырьки внутри неё, кольцо пузырьков уже колбы, у каждой декали крови есть текстура-заглушка, у собаки и учёных есть меткаmenu_action. Подмена арта — в модель, с которой снят её контракт, до входа в дерево подкладываются стекло сMAT_incubator_glass, меткиBodyAnchor/BubbleSource, декаль с готовой текстурой иAnimationPlayerсeat: колба берёт объём у стекла, а жидкость — его диаметр, мозг и пузырьки встают на метки, чужую текстуру заглушка не трогает, анимация играет. Общие материалы лампы и кольца колбы после ухода сцены — авторские. Имена меток и доля колбы берутся у скрипта колбы. Проверено мутациями: мозг мимо метки, свечение константой, невозвращённый материал, битый путь узла — каждая валит свои ассерты. Запускать после правокl_menu_map.gd,L_menu_map.tscn,e_incubator.tscn,incubator_flask.gd, заглушекsrc/levels/menu_map/stubs/и при приходе арта инкубатора.dev/depth_lighting_check.tscn— ассерты света по слоям (RS_DepthLighting,data/depth_lighting.tres). Данные — направление, а не числа: свет есть у каждого слояRS_LevelGraph.DEPTHS(слоёв света может быть больше — L5 заведён раньше генератора), глубже — не светлее (фон, лампы, туман не ярче, туман не реже, погасших не меньше), у поверхности погасших нет.world.tscn: окружение мира сapply_depth_lightingи фоновым светом в режиме «цвет» (в другом цвет слоя молча ничего не значит). Слои грузятся настоящимRunManager(_despawn_layer/_spawn_layer), лампы считаются в дереве: у поверхности горят все лампы коридора, на дне погасла доля около заданной, тот же мир гасит те же лампы, лампы на дне тусклее ровно во столько, во сколько велит слой; на каждом тайле один плафон (LampFixture), светится ровно у горящей лампы и на дне тусклее, тросик нашёл потолок коридора (после физкадра — меряется лучом); смена слоя перезапускает SDFGI окружения (выключен на кадр, затем снова включён). СинтетическийLevelEnvironmentс флагом на дне темнее, у поверхности без тумана, на дне туман плотнее, без флага не слушает слой, после снятия слоя возвращает авторское (и плотность тумана), общий.tresцел. Проверено мутациями: лампа без подписки наlayer_changedи стример, не снимающий погасшую лампу, валят каждый свой ассерт. Сейв забега подменяется и возвращается. Запускать после правокLevelLight,LevelEnvironment,LayerStreamer._spawn_corridor,data/depth_lighting.tres, окружения мира и сцен тайлов коридора,src/levels/lamp*.tscnиLampFixture. Как это выглядит — только плейтест (ниже).dev/soul_glow_check.tscn— ассерты свечения души (C_SoulGlow,S_SoulGlow) на настоящемe_player.tscn: лампа по пути компонента находится; на полном запасе —energy_full, у порога тускнеет и тем сильнее, чем ближе, но не нижеenergy_faded; во плоти свет следует за карманом тела (душа полна, тело на исходе — тускло), цвет перетекает к янтарю, а не прыгает, и приходит к палитре HUD (UI_HudMood.BODY), вне тела —SOUL. Числа — из компонента и палитры, не литералами. Запускать после правокS_SoulGlow,C_SoulGlow, лампы свечения вe_player.tscn,UI_HudMood.read_vitals/decay.dev/soul_cloud_check.tscn— облик души (C_SoulCloud,S_SoulCloud) на настоящемe_player.tscn: вне тела сгусток и след видны и идут, сгусток стоит в душе и уходит за ней; камера вплотную — сгусток гаснет (прозрачностью экземпляра), издали — плотный (мутация «без затухания» валит ассерт); ближе к распаду сгусток и след получают большийdecay, а частиц в следе меньше, но не меньшеdecay_amount(на спокойном запасе — ни того ни другого); основной меш рига (RS_EntityVisuals.primary) — пустой слот, а не частица облика; во плоти гаснет всё, а меш тела надет на слот; после пересадки тело→тело и выхода слот снова пуст, облик снова виден и стоит в душе, а не там, где прятался. Выход (O_SoulExit,SoulExitFx): душа уносит из тела лишь долю скорости (exit_inertia), брошенное тело — того, из которого вышли, вне мира ECS, без слоёв коллизий, уходит по инерции рига, сгорает (все меши в материале сгорания,burnидёт) и вместе с эффектом убирает себя; сгусток после выхода рваный и черезunfold_secondsснова по запасу; брошенное тело встаёт в переданную позу, а не в позу покоя (поза задаётся в проверке: риг пока без скелета, и снятие живой позы_worn_poseне проверяется). Сейв навыков снимается и возвращается (выход бывает «Чистым»). Проверено мутацией: слот меша, поставленный в сцене после камеры с частицами, валит ассерт про основной меш и обрывает блок, облик без_apply_decay— три ассерта распада, кости без скорости — ассерт инерции, тело без_ignite— два ассерта сгорания, без_apply_pose— ассерт позы. Коалесценцию remove+add при пересадке, от которой страхуетC_BodyVisual.restore_captured, проверка не воспроизводит: мутация «без флага» проходит. Запускать после правокS_SoulCloud,C_SoulCloud,O_BodyVisual,S_BodySnatch(облик),O_ExpelFromBody,O_SoulExit,SoulExitFx,body_burn.tres,UI_HudMood.decay, графаsoul_smoke.tresи порядка узловe_player.tscn. Как облик выглядит — только живой прогон.dev/character_check.tscn— контракт рига на стороне Godot ([[Пайплайн персонажей]]) по всем сценам обликаassets/characters/*/SK_*.tscn: у скелета есть костиRootиHead(именаSkeletonProfileHumanoid); каждое свойство*bone_nameузлов под скелетом — IK, CopyTransform, LookAt, физические кости, в том числе массивыsettings/N/...— называет существующую кость; каждый узел, записанный в.tscnоблика, нашёлся в собранной сцене; у каждой поверхности внешнийMAT_*. Ломается всё это молча: переименование кости или объекта в Blender не роняет ничего — Godot на загрузке только предупреждает «was modified from inside an instance, but it has vanished» и отбрасывает переопределение. Персонажей пока нет, поэтому детектор держит синтетика: облик в памяти чист, а каждая мутация (модификатор на несуществующую кость, кость в настройках IK, облик безHead, встроенный материал) валит свою сверку; потеря узла базы проверяется настоящей парой «база + унаследованная сцена» во временнойuser://character_check, удаляемой прогоном. Запускать после экспорта или переименования персонажа в Blender, правок сцен облика и при добавлении модификатора скелета.
Статистика генератора — какой пресет сколько раз выпал, где встретить, метрики
раскладки — не проверка, а инструмент: панель «Прогон сидов» вкладки
«Генератор мира» (addons/game_design_tool). Прежние dev/preset_stats.gd
(под --script, где автолоады не существуют и Entity не компилируется) и
печать dev/gen_verifier её дублировали и удалены.
Как писать проверку
Новый инвариант заслуживает проверки, когда его нарушение тихое — не падает с ошибкой, а молча меняет поведение (характеристика не перенеслась, граф распался, число ушло в ноль). Падающее с ошибкой ловится и без теста.
Проверяется наш код, а не Godot и не Blender (решение пользователя 02.11).
Ассерт, который зеленеет или краснеет от поведения движка или экспортёра при
неизменном нашем коде («кость доехала через glTF», «экспортёр снял смещение»,
«id кости появился через кадр»), — не проверка проекта: убрать или оставить
молчаливым условием, без которого проверять нечего. Знание о ловушке движка
живёт в вики и пометкой в коде. Это касается и тестов аддона Blender
(tools/blender/tests/).
Два требования, без которых проверка врёт:
- Зелёный прогон что-то значит, только если провал даёт ненулевой код
выхода. Обвязка
check_harness.gdделает это сама; проверка в обход неё, новый раннер или обёртка надgodotсначала проверяются на заведомо красном случае — иначе «всё прошло» может значить «ничего не проверено». - Настоящий сейв игрока проверка оставляет таким, каким нашла. Всё, что
пишет в
user://(WorldSave,SkillManager,ArchitectManager), до прогона копируется и после возвращается, включая случай «файла не было» — образец вdev/run_stats_check.gd(_save_backup/_restore_save). Отдельной временной папки для сейвов у проекта нет: пути зашиты константами автолоадов.
Куда класть: расширять существующий сценарий, если инвариант из той же области
(модель тела → dev/body_traits_check.gd, граф генератора →
dev/corridor_graph_check.gd, раскладка → dev/corridor_layout_check.gd),
и заводить новый dev/<область>_check.tscn + .gd только под новую область.
Скелет (scripts/check_template.gd — готовый файл
для копирования). Вся обвязка — счёт ассертов, итоговая строка, код выхода, мир,
системы, физкадры и сторож ошибок скрипта — живёт в dev/check_harness.gd, и
проверка её наследует:
extends "res://dev/check_harness.gd"
## Что проверяет и почему. Запуск: godot --headless dev/<имя>.tscn
func _ready() -> void:
var world := _new_world()
_add_systems(world, "gameplay", [S_Что_Проверяем.new()])
await _run(world)
_finish()
func _run(world: World) -> void:
# --- 1. Что именно проверяем ---------------------------------------
_check("человекочитаемое утверждение", условие, "детали при провале")Правила, вытекающие из устройства проекта:
- Сцена-обёртка обязательна. Запускать надо
.tscnс этим скриптом на корне, а не--script <файл>: под--scriptавтолоадов не существует,Entityне компилируется, и проверки молча деградируют (ровно этим был сломан удалённыйdev/preset_stats.gd). - Мир и системы поднимаются руками —
_new_world()и_add_systems(world, "группа", [...]), наблюдатели черезworld.add_observer(...). Берётся только то, что нужно проверке._add_systemsсортирует группу поdeps()так же, как игра: без сортировки проверка гоняет системы в порядке списка, которого в игре нет (так годами было не видно, что ход и прыжок применялись на тик позже — см.dev/system_order_check.gd). - Физика — из настоящего физкадра:
await _physics(n)прогоняет n тиков группы "physics"; если тику нужно больше (толкать тело, крутить "gameplay") — переопределить_on_physics_tick(delta). - Обрыв блока ошибкой скрипта — провал сам по себе. SCRIPT ERROR прерывает
только текущий блок, и раньше прогон доходил до итога с нулём провалов;
обвязка считает такие ошибки движковым Logger'ом и валит прогон. Считать
ассерты вручную (
EXPECTED_ASSERTS) больше не нужно. - Такт мира —
ECS.process(delta, "группа")с тем же именем группы, что у системы. Дельту задавать явно (0.016,1.0) — прогон не привязан к реальному времени, и «одна секунда» это буквальноECS.process(1.0, ...). - После
call_deferredнуженawait get_tree().process_frame. Развоплощение и переход через дверь отложены (правило v9), и без ожидания кадра проверка увидит состояние ДО них. - Ассерт формулируется как утверждение о поведении, а не о реализации: «остаток тела перетёк душе», не «поле current равно 119». Детали в третьем аргументе — они печатаются только при провале и должны объяснять, что пошло не так.
- Числа брать из
GameConfig/сцены, а не хардкодить, если они настраиваемые — иначе тюнинг баланса ломает тест, который ничего не поймал. Ассерт сверяет отношение («остаток тела перетёк душе», «ранг растит стат»), а не значение баланса (== 119.0, «перк: 2.0 + 2 · 0.5»). Исключение — таблицы спеки (hud_check): там число и есть требование.
Чего ассерт делать не должен — всё это нашлось при ревью проверок 08.10 и удалено:
- Утверждать литерал
true._check("не роняет", true)не может упасть; падение и так ловит сторож ошибок скрипта, а segfault — отсутствие итоговой строки. Сценарий оставить, ассерт убрать. - Повторять формулу проверяемого кода. Пересчёт маски поворота той же
rotate_maskили сдвига тряски тем же шумом зеленеет на любой мутации: сверяется функция с собой. Проверять наблюдаемое (лучи по коллизии, границы величины). - Сверять свой же литерал.
ResourceLoader.exists(OVERLAY_PATH), где путь — константа самой проверки рядом сpreloadтой же сцены, существует всегда. Брать значение у того, кто им пользуется (main.gd.DEBUG_OVERLAY_PATH). - Гонять собственный цикл вместо кода. «Максимум глубины монотонен»,
посчитанный
maxi()прямо в проверке, не трогалRunManagerвовсе. - Читать свойство константы.
const M := preload("…tres")и затемM.emission_energy_multiplier— анализатор GDScript сворачивает такое обращение при разборе, и проверка вечно видит значение из файла, а не живого ресурса (id совпадает, значение — нет). Ассерт «материал вернули» на этом зеленел при мутации; ресурс, который меняется во время прогона, держать полем (var m: StandardMaterial3D = preload(…)). - Держать ручной список имён. Список id навыков отстаёт от кода и падает
на переименовании, ничего не поймав; брать перечень из данных (
validate()дерева). - Дублировать чужой инвариант. Связность графа и детерминизм проверялись в трёх местах каждый; у инварианта одна проверка-хозяин, остальные ссылаются на неё комментарием.
- Проверять ключи перевода и тексты. Ни наличие ключа в
ui.csv, ни перевод, ни дословная строка не проверяются нигде (решение пользователя 15.10): такой ассерт сверяет таблицу с её копией в проверке, ломается от правки формулировки или от локали хоста и бага не ловит.tr()в проверке — только чтобы узнать, какую строку должен показать интерфейс. - Выход — через
_finish(): итоговая строка и код выхода, на которые опираютсяdev/run_checks.ps1и CI. Раннер верит итоговой строке больше, чем коду: проверка, сменившая сцену до своего quit(), выходит с чужим кодом. - Один инвариант — один ассерт. Перебор по сидам, узлам или сценам
собирает нарушения в список и засчитывает его одним
_checkс первыми примерами в деталях (образец —problemsвcorridor_layout_check). Ассерт на каждый элемент давал тысячи строк «ok» (world_gen_tool_checkпечатал их 2500) и прятал в логе CI единственный провал._print_passes = false— крайняя мера, а не норма. - Сейвы в
user://— настоящие сейвы разработчика, отдельного каталога у проверок нет. Писать туда может не только явный вызов, но и механика по дороге: «Чистый выход» из тела начисляет очко и сразу сохраняетskills.tres, контрольная точка пишетworld_save.tres. Проверка, которая дёргает такую механику, снимает байты файла в начале_ready()и в конце возвращает их ассертом — какrun_stats_checkиabilities_check. Утечку видно только по значениям в файле: прогнать проверку, сравнивskills.tres,architect.tres,world_save.tresдо и после.
Дописав проверку по этому шаблону, регистрировать её в dev/run_checks.ps1
не нужно — файл, названный dev/<область>_check.tscn, скрипт находит сам
(-ListChecks покажет, что подхватилось). Обновить стоит только
§«Что именно проверяется» здесь — что именно проверка покрывает и после каких
правок её запускать, скрипт этого сам не знает.
Чек-лист ручного плейтеста
Headless-проверки покрывают структуру, не ощущения. После них — реальный
прогон: играть world.tscn напрямую (пропустить меню) или через
New Game из L_menu_map.tscn, если менялся флоу старта. Смотреть
конкретно на область правки:
Состояние для прогона набирается оверлеем, а не забегом. В отладочной сборке
поверх мира висит панель читов (dev/debug_overlay.tscn, F1 — свернуть):
экран навыков не отходя от места, телепорт по слоям, выключенный распад, а в
меню отладки (`) — очки навыков пачкой и эссенция Архитектора (уровень
карты комплекса покупается ею). Раньше, чтобы посмотреть на правку в дереве навыков, нужно
было бегать пару минут ради очков — то есть цена взгляда была выше цены правки.
Подробности и границы: [[Отладочный оверлей]].
- Обводка силуэтом (
S_OutlineMask) — headless не рисует ни одного пикселя, поэтому картинка проверяется только здесь. Смотреть: контур ровной толщины и на мелкой детали, и на крупной стене; у составного объекта (дверь = рама + полотно + ручка) ОДИН силуэт без внутренних рёбер; ничего не мерцает, хотяmaterial_overrideна объектах больше не стоит; объект вплотную и в паре метров, объект у края экрана — контур не обрезан; наведение и снятие не оставляют контур висеть. Заодно снять кадровое время с выделенным объектом и без него — цена постэффекта в карточке значилась риском. - Захват тела: тело село вровень с полом, а не утоплено/парит (регрессия
foot_offset/типа коллайдера —body_traits_checkловит только что офсет не нулевой, не то что он верный визуально); обводка красится по всей сложной геометрии, а не только по части меша; пробовать захват в заспавненной комнате, а не только в хабе — там своя геометрия пола, и именно там нашёлся баг «Тело здесь не поместится» на штатно стоящем теле (body_form_checkтеперь это проверяет headless, но по-другому расставленное новое тело/комната всё ещё стоит пощупать глазами). - Двери/переход: игрок появляется перед дверью, ведущей назад, лицом в
комнату (не боком); прицел не сбит рывком (пишется только позиция, не
поворот — см.
CLAUDE.md, «Doors ↔ graph edges»); дверной порог проходится шагом, не прыжком (S_Movement.STEP_HEIGHT— см. ниже). - Коридоры и раскладка сетью (п. 7 «Сетки уровня»): headless сверяет маски
и лучи, а не то, как этаж читается. Пройти пару этажей целиком (телепорт по
слоям — оверлей): коридор подходит к комнате с одной-двух сторон, а не
обходит её; две двери одной комнаты в разные коридоры — это обход, по нему
реально вернуться другим путём; петля по коридору не выглядит вторым рядом
вдоль того же коридора. Тупик (
SM_corridor_P_end, 1–2 клетки от коридора): стоит проёмом к коридору, без щелей и провала на стыке, свет в нём есть, и читается он нишей, а не недостроенным проходом к двери. Стык двух коридоров на развилке не отличается от обычного коридора (шлюзов пока нет). Карта (мини и экран,M) рисует тупик рукавом и кольцо коридоров без разрывов. - Коридор — отдельный узел: текущий узел меняется на каждой развилке при входе в боковой коридор, а не посреди прямого; мини-карта (посещённое и соседи) при коридоре на отрезок показывает сеть кусками — проверить, что это читается, а не выглядит обрывками; «Комнат посещено» в итогах забега не растёт от коридоров.
- Сейв прежнего генератора: забег, сохранённый на версии генератора ниже 2 (или
с правленой
generator_versionв сейве), грузится у входа, с тем же запасом и телом; карта пуста, посещённых нет — а не в чужой комнате. - Перешагивание порогов (
S_Movement): мелкие ступеньки и кромки комнатной геометрии (< 0.16 м — дверные пороги, стыки меша) проходятся ходьбой без рывка/подлёта, который выдавал бы телепорт вверх; настоящая стена или высокий бортик по-прежнему не пускают. Смотреть также на теле меньшего роста («ползун») — у него капсула тоньше, и естественный «перекат» гологоmove_and_slide()слабее, так что правка там нагляднее. Уперевшись в настоящую стену, прыжок обязан срабатывать сразу (был баг:_try_step()портилis_on_floor()на кадр, и прыжок у стены иногда молча не выходил). - Промпт интеракции: показывает верную клавишу для действия
(
SettingsManager.action_display_name()), перерисовывается сразу после ребайнда в настройках без выхода из игры. - HUD «Отголосок» (
hud_checkсверяет числа, а это — ощущение; спека — [[HUD — спека]]): дуга у прицела сиреневая вне тела и янтарная во плоти, переключается на вселении и выходе за четверть секунды с волной от краёв; на спокойном запасе гаснет, на заметном скачке и ниже 35 % видна, ниже 15 % бьётся. Ранний распад не давит постоянно — только слабая база, нарастание у порога. Излишек после выхода из тела — внешняя дуга с искрами. Во плоти при малом HP кровь пятнами по краю (не ровным кругом), удар — вспышка (сильнее от тяжёлого удара) и лёгкая тряска, пятна после удара ложатся иначе и перетекают, а не прыгают. Подсказка и сообщение читаются на светлой стене без плашки; «эхо» текста дрожит, а не двоится грязью; английский (сменить язык системы) не вылезает за края. Управление появляется на вселении и гаснет через ~4 с. Удобная сцена — оверлей: бессмертие выкл., тело с врагом рядом. - Мини-карта по Tab (нужен ранг «Карты комплекса»: эссенция из меню отладки, покупка у Архитектора): открывается на ходу без паузы, Распад под ней тикает, мышь крутит камеру; контуры прорисовываются от текущей комнаты наружу, подписи — следом; точка игрока идёт за ним по коридору; Tab растворяет, M сворачивает её и открывает полную карту (только на последнем ранге, ниже — строка про терминал). Коридоры — бусы на нитке: нить только через открытые проёмы, так что соседние несоединённые ветки не сливаются в сетку; узнал новую комнату — карта плавно перевписывается, без скачка. Рамка рвётся, как дуга распада, но тише, и не спорит с точкой игрока; на светлой стене всё читается за счёт тени-пятна.
- Враг (
S_EnemyAI): на расстоянии стоит, при подходе разворачивается и бежит без рывков и залипаний в геометрии; в упор реально снимает HP (у края экрана проступает кровь, удар трясёт кадр), а не бьёт сквозь стену; добитое тело выбрасывает игрока в призрака без зависаний. Headless проверяет числа и переходы состояний, не то, ощущается ли погоня как угроза, а не декорация. Навигация и обнаружение: враг не замечает через стену и за спиной (но вплотную замечает), обходит угол комнаты и коридора, а не упирается в него; потеряв из виду, идёт на место, где видел, и сдаётся, а не бежит прямо к игроку; сразу после входа в слой (первые доли секунды, пока навмеш запекается) идёт по прямой без залипаний. Отладочный вид навмеша — Debug → Visible Navigation в редакторе. - Прототип v0.7.0 — цикл от и до (волны 1–2, [[Игровой цикл — от и до]]
§10). Headless сверил числа и детерминизм; здесь — читается ли цикл. Пройти
«Новой игрой» от колбы до двери наружу, остальное добрать телепортом оверлея:
- Удар (ПКМ): во плоти бьёт то, на что смотришь, сквозь стену — нет; в
теле без
C_Attack— «нечем бить», в призраке — ничего. Добитый враг в тот же миг становится трупом на своём месте (без прыжка и мелькания), труп захватывается, удар переезжает с телом. - Ростер по слоям: на L0–L1 учёные, на L3 военные, на L4 военные и гончие, на дне существа L5; враги стоят на полу, не в стене и не в двери, часть маркеров пуста. Вошёл в слой второй раз — те же враги на тех же местах.
- Существо L5: крупнее гончей и красноватое — читается как другой класс издалека. Удар слабым телом почти не снимает HP (×0.1), телом L5 — в полную силу; понятно ли игроку, почему, — записать (подсказки нет, хвост в [[Бой — начало]]). Захватить труп L5: камера на высоте глаз туши (2.56 м) не в потолке и не в полу, тело помещается в коридоре и проходит в дверь.
- Очки души и навыки: первое тело вида даёт больше повторов; ранг с условием показывает прогресс в карточке навыка и после выполнения даёт бонус.
- Эссенция: в комнатах есть находки, в тупиках иногда тайник; подбор показывает «Эссенция: +N», без навыка «Сбор эссенции» N около трети диапазона, с полным навыком — весь. Взятое не появляется после выхода в меню и загрузки; в итогах забега находки и тайники — отдельными строками. Призма-заглушка видна, но не бросается в глаза как мусор геометрии.
- Архитектор: улучшения раскладки покупаются эссенцией и чувствуются в следующем забеге (меньше тупиков, переходы ближе), а не в текущем.
- Подача цели: первая мысль ходока «Наверх. Выход на нулевом.» выходит через секунду после захвата и не сбивает строку HUD; полоса L0 на карте подписана «выход». Надписей и подсказок у дверей и порталов нет (16.10).
- Концовка: дверь «Наружу» в комнате выхода → затемнение, текст, титры, сводка; Esc пропускает; главное меню после — «Комплекс покинут», «Новая игра» снимает отметку.
- Удар (ПКМ): во плоти бьёт то, на что смотришь, сквозь стену — нет; в
теле без
- Вывод редактора (Output) во время игры — открыт при запуске из
редактора:
push_error«structural change during zero-copy system iteration» значит, что где-то вprocess()структура мира менялась напрямую в обходcmd-буфера (см. «Правило v9» вCLAUDE.md) — тихий баг, который headless-прогон не покажет, если сценарий теста не задел ровно тот код-путь. - Оверлей «Сетка» «Генератора мира» — headless считает отрезки, а не то, как схема читается. Новый оверлей появляется только после перезапуска редактора (или выключения-включения плагина). С выключенной «Геометрией»: решётка тёмная и не спорит с контурами, стрелка поворота не мерцает на перекрестье, стрелки дверей видны рядом с плитами «Коридоров» и указывают внутрь комнаты, крест тупика и черта стыка находятся глазом; выделение комнаты перекрашивает её контур и стрелку. С включённой — линии под потолками не лезут поверх мешей.
- Экран карты комплекса (
Mили терминалscreen2в хабе) — headless проверяет данные и обратную проекцию, не картинку. Уровень карты ставится рангами «Карты комплекса» у Архитектора; эссенцию на них — из меню отладки («Прокачка»), экран Архитектора — телепортом в его комнату там же. Смотреть: этажи рядом не слипаются, клетка не раздута на крошечном этаже (MAX_STEP), ромб портала со стрелкой читается в углу комнаты и не лезет на значок содержимого, буква заглушки по центру круга, строка под картой меняется при наведении, клик по порталу переносит на слой и рамка видна; терминал подсвечивается обводкой целиком и подсказка «Карта комплекса» появляется у экрана, а не в стороне; без улучшения — строка «Нет связи с Архитектором», курсор после закрытия снова захвачен. - Шторка загрузки (
UI_LoadingScreen, «Новая игра», «Загрузить» и «Возродиться»): после смены сцены шторка видна с первого кадра мира, строка «Комплекс перестраивается…» дышит, а не стоит (стоит только на спавне слоя, доли секунды); Esc до конца загрузки паузу не открывает; шторка гаснет без рывка за ней — первый кадр слоя должен пройти под ней. Снять в профайлере, чтоgenerate_runбольше не в кадре входа. Переход порталом: F6/F7 оверлея идут тем же путём, F2 меняет вид — затемнение и шторка. В обоих: рывка нет, душа после перехода стоит у портала, а не падает; на затемнении экран не остаётся чёрным; выход в меню из паузы и побег — без пустоты под меню, пункт бежит штрихом. - Экран смерти / итогов забега — тема
assets/ui/default_theme.tresприменилась (не белые Control без стилизации — признак дублирующегоtheme = ExtResource(...)в сцене): заголовок прописными с эхом, строки «показатель ···· значение», по фону точки поднимаются вверх; на «Возродиться» штрих под кнопкой бежит, пока строится забег. - Меню «Отголосок» (главное, пауза, настройки) — наведение мышью даёт эхо и
бледный штрих, стрелка с клавиатуры ставит фокус (точка души слева, штрих в
полную силу) и отличается от наведения; экран входит проявлением, а не
скачком, и гаснет при закрытии; под паузой мир размыт и обесцвечен, а не
закрыт панелью; «Сохранить» отвечает на себе «Сохранено» со значком;
«Загрузить» без сейва недоступна и подписана «нет сохранений». Английский
(
TranslationServer.set_locale("en")) не ломает ни одной строки. - Сцена за главным меню (инкубатор,
menu_scene_checkсверяет числа) — колба справа, меню слева не спорит с ней; свечение колбы живое, но не пульсирует заметным ритмом; лампа в глубине мигает сериями и комната проступает только во вспышку; собака над телом читается и сквозь размытие; кровь видна, а другого красного в кадре нет; камера дышит, а не плывёт. Мозг и пузырьки видны сквозь стекло с толщиной и не вылетают над крышкой — пропали, значит пузырьки снова стали прозрачными (§8 спеки). Снять кадровое время: объёмный туман, SDFGI и глубина резкости в меню включены одновременно. - Меню настроек — открыть обоими входами: из главного меню и из паузы.
Вкладки выглядят вкладками (стили
TabContainerберутся из темы, headless их не рисует), переключение не дёргает размер панели, «Отмена» возвращает туда, откуда пришли, а курсор после закрытия ведёт себя по правиламUIManager. Ребайнд щупать именно здесь: ловля нажатия идёт в_input, иEscобязан отменять захват клавиши, а не закрывать экран. - Яркость и эффекты освещения — числа сверяет
settings_menu_check, а картинку только глаз. В тёмном углу комнаты подвигать «Яркость»: тьма без лампы светлеет, а освещённое лампой не меняется (кривая поднимает только то, что ниже колена), пересветы у ламп не выгорают в плоское белое. Экран калибровки (удалитьuser://settings.tresили снять в нёмbrightness_calibrated— и запустить главное меню; второй вход — «Калибровка яркости» в настройках): на своём мониторе найти положение, где левый знак виден, средний едва виден, а правый нет, — и проверить на L4 в тёмном закоулке без лампы, что стены при этой яркости тоже «едва видны», а комнаты с лампами не пересвечены; при перекрутке правый знак проступает. «Эффекты освещения» по ступеням: «Низкие» дают затенение в стыках пола и стен, «Средние» — подкраску соседних стен светом ламп, «Высокие» — отражения на глянце, «Ультра» — отражённый свет от стен вне кадра (SDFGI); снять кадровое время на каждой. На «Ультра» тёмный угол без лампы темнее, чем на «Высоких», а на стенах пятна засветов — это известно (14.10: SDFGI вытесняет фоновый свет слоя и течёт сквозь стены без толщины) и ждёт толстых стен; после их пересборки сравнить снова. После портала отражённый свет не должен «помнить» стены прошлого слоя. Туман: в длинном коридоре дальний конец растворяется в темноте, а не обрывается погасшими лампами, и граница не «прыгает» при смене ступени теней. - Свет по глубине (
data/depth_lighting.tres) — пройти телепортом оверлея (F6/F7) все слои при яркости 100 %: у поверхности (слой 0) заметно светлее, чем на дне (слой 4), и каждый шаг вглубь читается темнее; на дне стены вне пятна лампы — тёмно-синие очертания, а не ровная чернота; провалы погасших ламп коридора читаются участками без света, а не дырой в мире, и выход из такого участка видно; углы не залиты плоским светом (SSAO на месте); туман: на L0 дымки нет вовсе, на L1 она едва заметна и только вдали, глубже — дальний конец коридора уходит в почти чёрную темноту. Плафоны: цепочка светящихся панелей читается в тёмном коридоре, тросик упирается в потолок, а не висит в воздухе и не торчит сквозь него, у погасшей лампы плафон тёмный; в виварии панель не выжигает кадр. Свечение души: вне тела сиреневое пятно вокруг, во плоти янтарное, перетекает за четверть секунды вместе с дугой; на спокойном запасе ровное, у порога распада тускнеет; у стены не засвечивает заметно соседнюю комнату.
Границы
- Не переписывать/расширять
dev/corridor_graph_check.gdилиdev/body_traits_check.gdмимоходом, в рутинном прогоне — это тестовые сценарии проекта, их правка (новые ассерты, новые инварианты) отдельная задача с собственным ревью, не рутинный прогон. - Не считать headless
OKподтверждением фичи целиком — это подтверждение инварианта, который проверяет конкретный сценарий, не больше.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

