Проверяемая 3D-игра на Godot 4

Дополняет скил godot-codefirst (код-первый подход, старт проекта, материалы и
шейдеры, звук, общая оптимизация). Здесь — то, чего там нет: как агенту
увидеть результат своими глазами, физика, корректность процедурного меша и
сеть. Всё проверено на 3D-хорроре в процедурном лабиринте (см. ORIGIN.md).

Свет и рендер интерьера

Какой GI печётся из кода, реальные значения солнца, теней и Environment из
официальных демо, и ловушки — искры от карты нормалей, невидимая крыша,
затухание точечного света: references/interior-lighting.md.

Главное правило

Не проси пользователя смотреть то, что можешь посмотреть сам.

Godot умеет отрендерить кадр в PNG и выйти. Один раз написанный
скриншот-харнесс (--shot=out.png + флаги) превращает «посмотри, пожалуйста»
в цикл, который агент крутит сам: правка → кадр → правка. Плюс A/B-флаги
(«выключи этот эффект») — главный инструмент диагностики визуальных багов.

G=./Godot_v4.7-stable_win64_console.exe        # console-сборка: пишет в stdout
$G --path game --headless --quit-after 600     # логика: падения, ошибки API
$G --path game --resolution 1280x720 -- "--shot=C:/tmp/f.png" "--shot-frames=150"

--headless для скриншота НЕ годится. Симптом хуже, чем чёрный PNG: процесс
не пишет файл вообще и висит, пока его не убьёшь — ждать бесполезно.
Двойное -- обязательно: всё после него уходит в OS.get_cmdline_user_args().

FPS, который печатает харнесс, — не FPS игры. Кадр снимается в
суперсэмплированный офскрин-буфер, и число относится к нему. На одинаковой
работе оно давало 83, 4, 15 и 1, и по нему был сделан целый заход
оптимизации впустую. Мерить производительность только снаружи: фиксированное
число кадров обычным запуском и часы (Measure-Command + --quit-after N),
обязательно парой «с фичей / без фичи». Подробно — скил measurement-sanity.

Границы честности: композицию, цвет и «страшно/красиво» headless не проверяет.
Здесь проси пользователя посмотреть — и говори КОНКРЕТНО, что оценить.

Три диагноза, которые ставятся флагом за минуту

Отладочный вывод внутрь шейдера (нормаль/UV/маска цветом) — самый быстрый
способ понять геометрию, когда картинка «просто неправильная».

Что читать дальше

Рабочие привычки

• Каждая тяжёлая правка заканчивается прогоном --headless --quit-after N и
  кадром через --shot=. Не «кажется, работает», а лог и картинка.
• На каждый спорный эффект — флаг, который его выключает. Два кадра рядом
  отвечают на вопрос за минуту, гадание — за час.
• Замеры производительности клади в коммит парой «было → стало» и с железом.
• Всё процедурное — от явного сида (RandomNumberGenerator со смещением на
  подсистему). Это даёт воспроизводимый баг, стабильные A/B-кадры и мир,
  который в сети не надо пересылать.
• Комментарии и UI — на языке пользователя.