- Отставание пропа: в rapier 0.36 `normalized_max_linear_velocity` по
умолчанию 400, всё выше обрезалось на шаге (1200 → 400). Поднято до 100k;
тест-страж body_with_set_velocity_actually_moves (1200 за секунду).
- Управление как в GMod: колесо тянет/толкает вдоль луча (`physgun_wheelspeed`,
шаг 16, минимум 24), вращение — зажатый E + мышь (камера стоит). Держится
полная ориентация (pitch/yaw/roll), угловая скорость — по кватерниону
кратчайшей дуги, а не только yaw.
- Демпфирование: `physgun_maxSpeedDamping`/`maxAngularDamping` = 10000 —
предел изменения скорости (damp_towards), а не самой скорости.
`physgun_DampingFactor` в вики не указан, у поверхностей dampening 0.
- Undo как в оригинале: отменяется только спавн; Move/Freeze из истории
физгана убраны.
- Вьюмодель физгана: `weapon_physgun.txt` → `c_superphyscannon.mdl`, анимация
`idle` обязательна (bind-поза разваливается), посадка right 25/up −25/
dist 34/scale 0.9, ствол вдоль +X.
- CCD: пропы с `ccd_enabled(true)`, `max_ccd_substeps` 4,
`num_solver_iterations` 8 — быстрые пропы не пролетают сквозь карту
(тест на 5000 юнитов/с).
- HUD: wheel dist | E rotate.
Проверки: clippy -D warnings, cargo test --workspace зелёные; кадр
/tmp/opencode/physgun_final.png.
Посадка вьюмодели вынесена в таблицу по модели: у w_pistol ствол вдоль +Y, у v_pistol/c_smg1 — вдоль +X, поэтому общие view_yaw/дистанция не работали. В движке появился масштаб экземпляра и полный доворот модели; для w_pistol/v_pistol/c_smg1 подобраны дистанция, смещение, масштаб и yaw, near-плоскость не режет ни одну модель.
weapon_pistol в HL2 — движковое оружие, его Lua-скрипта в ассетах нет. Добавлен встроенный SWEP (Slot 1/SlotPos 1, 18 патронов, одиночный огонь) с регистрацией в weapons и list.Get("Weapon"); пользовательский lua/weapons/weapon_pistol.lua важнее встроенного. ViewModelFOV и необязательные ViewModelOffset/Angles/Scale из SWEP перекрывают таблицу.
Проверено кадрами на Xvfb: пистолет и флечетган в кадре, ближе_near=0, выстрел 18→17, слот 1 после флечетгана и кулаков возвращает пистолет, c_arms по-прежнему скрывается. Добавлен SOURCE_RS_TEST_SLOT для синтетической клавиши слота (xdotool не доставляет клавиши в SDL-окно на Xvfb).
- MDL: разбор mstudiomodel_t/mstudiomesh_t (vertex_offset, material,
vertex_index); VTX origMeshVertID складывается со смещением модели и
меша, а не читается как глобальный индекс VVD. Это чинит «взрывы»
второго меша у v_pistol/c_smg1 и многоматериальных пропов.
- Материал меша берётся из MDL; пустой список замен VTX больше не
выдаётся за индекс материала.
- Тест-страж real_model_meshes_are_coherent: вырожденные треугольники,
максимальное ребро и диапазон вершин своего меша.
- Физика: динамический проп при спавне поднимается до статической опоры;
real_map_props_rest_on_ground меряет проникновение лучом без своего тела.
Пользователь: в оригинале Ctrl в ноуклипе замедляет движение. Убрано
`move_up -= 1` по Ctrl; скорость: Shift ×3, Ctrl ×0.35, иначе обычная.
Плюс тесты-сканы карты: поверхности с «зеркальными» материалами (0 в зале) и
сущности рядом с залом — подтверждают, что func_reflective_glass один
(model *6, точка -2064 -2076 -286).
- сборка мира: для каждого infodecal берётся ближайшая плоскость грани (замер:
у всех 19 декалей расстояние 0), центр проецируется на неё, квадрат строится
по осям текстуры грани (32×32 юнита), материал — `decals/<имя>`;
- рендер: материалы с префиксом `decals/` идут отдельным проходом с
ALPHA_BLENDING, без записи глубины, после непрозрачного мира; новый шейдер
`fs_decal` берёт цвет из обычного освещения, альфу — из текстуры;
- декаль освещается ambient'ом в своей точке (`model_light_at`).
Проверено кадром: граффити с прозрачностью лежит на кирпичной стене.
25 сьютов и 29 картовых тестов зелёные.
- сборка мира: модель зеркала помечается материалом-меткой `<mirror>` до
резолва материала (у reflectiveglass001 нет VTF, иначе грань выпадала),
из её граней строится плоскость MirrorPlane (origin, normal);
- рендер: проход отражённой камерой в текстуру Rgba16Float, клип по плоскости
зеркала (vec4 в uniform камеры, discard в шейдере), грань зеркала сэмплирует
отражение по экранным координатам;
- отражение привязано на слот лайтмапы (группа 3) отдельным bind group:
у устройства max_bind_groups = 4, пятая группа не создаётся;
- обычный проход пропускает зеркальные батчи (иначе чекер-заглушка
перекрывала отражение), зеркало рисуется после непрозрачного мира;
- найден и исправлен пропуск слота `sun` в Camera у world.wgsl (из-за него
fog_color читался со сдвигом).
Проверено: 25 сьютов и 29 картовых тестов зелёные; UV-градиент на грани
подтвердил плоскость и шейдер, отражение показывает стену и потолок.
- PostProcess: 3D-текстура LUT 32³ Rgba8Unorm (по умолчанию тождественная),
сэмплер, биндинги 4/5 в композите; set_color_lut принимает raw Source
(32³ RGB, красный меняется быстрее всего) и включает флаг use_lut.
- post.wgsl: после ACES цвет переводится в sRGB, сэмплируется LUT и
возвращается в линейный (поверхность sRGB-ная).
- Клиент: читает materials/colorcorrection/<карта>.raw из VFS; для
gm_construct файл есть. Отключение — SOURCE_RS_NO_COLORCORRECTION=1.
- Замер: gm_construct.raw нейтральный (0/66/132/195/255 по диагонали), то есть
грейда у карты нет by design — цветокор включён, но визуально не меняет.
- Тест real_map_visual_entities: на карте есть func_reflective_glass (зеркало),
env_tonemap_controller, 19 infodecal, env_sky/tonemap — записано в дневник.
Все сьюты зелёные.
`quat_from_angles` собирал поворот как Rz(roll)·Ry(yaw)·Rx(pitch), а рендер
(`rotate_model_vector`) — как Rz(yaw)·Ry(pitch)·Rx(roll). Из-за этого меш
двигался по одной ориентации, а тело — по другой: арбуз катился, но выглядел
как юла (жалоба пользователя).
Теперь конверсия в обе стороны точная; добавлен тест
`physics_angles_match_render_rotation` — пять наборов углов, проверка
кватернион→вектор против рендера и обратно.
Плюс тест `real_map_props_stay_stable`: 10 секунд физики на gm_construct —
ни один проп не поднимается выше 20 юнитов и не разгоняется выше 500 ед/с
(«пропы летают» от выталкивания геометрией не подтвердилось — 0 из 4).
Пользователь видел пистолет «повёрнутым на 90° влево». Причина: клиент
выбирал для вьюмодели анимацию `idle`, а у `w_pistol` единственная `idle` —
это `@idle` мировой модели, где RAWROT2/RAWPOS задают позу **брошенного на
землю** пистолета (ствол вбок, меш на боку). В руках эта поза не годится.
Теперь для вьюмодели берутся только `idle01`/`idle01empty` (у моделей `v_*`);
если их нет — остаёмся в позе покоя, которую доворачивает `model_yaw` (-90°).
Замер в осях камеры (новый диагностический лог SOURCE_RS_VIEW_DEBUG):
до правки «вперёд 1,7 / вправо 10,6» (ствол вбок), после — «вперёд 10,6 /
вправо 1,7» (ствол вперёд). Кадр подтверждает: пистолет смотрит вперёд, виден
сзади, рукоять вниз.
Замер: для gm_construct реально читаются 335 файлов из VPK на 27,0 МБ
(277 материалов, 23 модели, 35 Lua-скриптов; крупнейшее — m_anm.ani 6,8 МБ)
плюс карта 35,0 МБ. Итого 62,1 МБ сырых, 31 МБ в tar.gz — против 6,7 ГБ
полной установки. Этого набора достаточно: клиент запускается с ним, карта
и пистолет полностью текстурированы (проверено кадром).
- VirtualFs: запись успешных чтений (start_recording/take_recorded);
- команда `gmod-rs fs pack <карта> --out <каталог>`: собирает мир, грузит
модели игрока и оружия, автозагрузку Lua и копирует прочитанные файлы в
структуру garrysmod/... плюс карту — получается самодостаточный корень
ассетов для `--assets`;
- android/build.sh: если есть android/assets/gmod (или GMOD_RS_ANDROID_ASSETS),
каталог кладётся в APK как assets/gmod;
- MainActivity: при первом запуске распаковывает assets/gmod в
files/gmod_server/server, если карты там ещё нет — APK самодостаточен,
adb push не нужен;
- .gitignore: android/assets/ (ассеты GMod не коммитим).
Все сьюты зелёные.
Из ветки feat/anim (d42d646):
- распаковка постоянных дорожек: Quaternion48 (RAWROT), Quaternion64
(RAWROT2), Vector48 (RAWPOS) — раньше такие кости застревали в позе покоя
(в @taunt_muscle_base 24 дорожки из 53);
- engine::animation — выбор секвенции по состоянию: стоя/шаг/бег/присед/
воздух, 8 направлений относительно взгляда, сохранение фазы walk↔run;
- клиент: покачивание вьюмодели при ходьбе, инерция взгляда, одиночный
выстрел fire по ЛКМ, компенсация RAWPOS-сдвига корня (у v_pistol 68 юнитов).
Разрешение конфликтов: вьюмодель осталась в камерном базисе (мои правки —
смещения через up камеры, доворот model_yaw), анимации и покачивание взяты
из ветки; play_model_animation с шестым аргументом model_yaw во всех вызовах.
Проверено: 23 сьюта, 29 картовых тестов, 15 тестов world_real — зелёные.
Вьюмодель (жалобы пользователя):
- доворот ствола (-90°) теперь применяется в координатах модели, до поворота
камеры: прибавка к мировому yaw при взгляде вниз превращалась в крен;
- смещения (вправо/вниз) задаются в базисе камеры, а не мировым (0,0,-12) —
иначе при наклоне камеры вьюмодель уезжала к центру экрана («ось ниже»);
- play_model_animation принимает model_yaw (доворот модели), rewrite_instance
тоже — путь без скелета больше не теряет ориентацию.
Коллизия пропов из настоящего меша:
- Physics::add_prop_hull — выпуклая оболочка вершин модели для динамических
пропов (как vcollide в Source), вместо коробки с выступами;
- Physics::add_static_mesh — тримеш из треугольников модели для prop_static:
раньше у статических пропов коллизии не было вовсе, игрок проходил сквозь
мебель;
- PropMesh хранит индексы модели; оба места создания тел используют оболочку
(с откатом на коробку, если вершин < 4).
Все сьюты и 29 картовых тестов зелёные.
- formats: Quaternion48/Quaternion64/Vector48 (RAWROT, RAWROT2, RAWPOS),
приоритет постоянных значений в frame_pose;
- engine::animation: выбор idle/walk/run/crouch/jump по скорости, приседу,
земле и восьми направлениям относительно взгляда, сохранение фазы walk↔run;
- клиент: модель игрока играет выбранное имя, вьюмодель качается на ходу,
отстаёт при повороте и проигрывает fire по ЛКМ; центр анимированной позы
компенсирует RAWPOS корня;
- тесты: RAW на v_pistol/m_anm, имена и проигрывание секвенций, чистый выбор
и фаза; docs A26 обновлены.
Коробка-коллайдер ставилась от нуля модели, хотя геометрия часто смещена
(у куклы центр AABB на 13,5 юнита выше нуля, у стола — 9,5 вбок по X). Из-за
этого предметы висели на невидимых выступах: их держала коробка, сдвинутая
относительно меша (жалоба пользователя, кадр с парящими столом и куклой).
- Physics::add_prop_offset — смещение коллайдера в координатах модели,
поворачивается вместе с телом (Rapier ColliderBuilder::translation);
- оба места создания тел (пропы карты и spawn_prop) передают bounds_center;
- World::prop_collision_boxes — коробки для коллизии игрока с учётом центра и
поворота (AABB описанной коробки по модулю матрицы поворота); клиент больше
не собирает их вручную;
- тест physics::prop_collider_honours_model_center_offset — без смещения проп
висит на 30+ юнитов выше пола, со смещением низ ложится на пол;
- тест real_map_props_rest_on_ground — после 10 с физики низ коробки каждого
пропа на опоре (кукла лежит краем на столе, центровой луч этого не видит).
Все сьюты зелёные.
Замеры на реальных ассетах, которые пригодятся для дальнейших правок:
- v_pistol: 1 бодипарт, 2 меша (1169/4356 и 988/2448), 2157 вершин, 2167 в
VVD (10 не используются), кадры лежат внутри MDL, флаги дорожек
2/3/8/12 (RAWROT/RAWPOS/ANIMROT/ANIMPOS);
- скиннинг вьюмодели не разваливает меш: между позой покоя и кадром idle01
максимальный сдвиг 4 юнита, габарит 20×23×13;
- v_pistol рисуется «лепестком» даже в позе покоя (до скиннинга) — проблема
загрузки геометрии именно этой модели, отложена; по умолчанию w_pistol.
Все сьюты зелёные.
Падение wgpu на втором спавне («Copy at offset ... overrunning the bounds»):
буферы GPU создавались под размер мира при загрузке и не росли. Появился
WorldRenderer::ensure_capacity (рост вдвое + перезаливка) и refresh_materials
(bind group для материалов, появившихся после спавна, — иначе новые батчи
молча не рисуются).
Вьюмодель:
- обновляется после player.update и camera.pos, а не до них: раньше она
отставала на кадр при ходьбе и «плыла» при повороте (жалоба пользователя);
- по умолчанию w_pistol.mdl вместо v_pistol.mdl: v_pistol у нас рисуется
развёрнутым полотном (2157 вершин, 2 меша — разбираться отдельно), а w_pistol
выглядит пистолетом;
- курс -90°: у модели ствол смотрит вдоль +Y (влево), а не +X — без доворота
пистолет лежал поперёк кадра;
- дистанция 26, сдвиг вправо/вниз, анимация idle01 (у w_pistol свои кадры
в MDL).
bone_world_transforms теперь обходит кости рекурсивно: порядок «родитель
раньше ребёнка» в файлах не гарантирован.
HUD: журнал и отладочные строки скрыты по умолчанию (клавиша `), строка
verts/tris убрана.
Плюс тесты на реальных ассетах: кости вьюмодели не разваливаются при
скиннинге (макс. сдвиг 4 юнита), структура моделей оружия, встроенные кадры.
Все сьюты зелёные, clippy чистый.
Спека декодера взята из настоящего bone_setup.cpp (Mapbase-зеркало SDK 2013).
Прошлые догадки были неверны, и это зафиксировано в docs/PARITY.md: каналы
дорожек — не компоненты кватерниона, а углы Эйлера (raw · rotscale + поза
покоя, затем AngleQuaternion); позиции — raw · posscale + bone.pos; значения
блоков не накапливаются дельтами (ExtractAnimValue идёт по блокам valid+1
записей, внутри блока value[k], дальше повтор последнего); флаг DELTA означает
относительные каналы без позы покоя.
Замеры на живых данных, три теста в tests/world_real.rs:
- @taunt_muscle_base (451 кадр, 53 дорожки): углы ≤ 4,75 рад, сдвиги позиций
≤ 28,5 юнитов, кватернионы единичные — при новой спеке нарушений нет;
- кости локальны родителю (цепочка 4,0 / 3,5 / 8,9), корень — таз на 38,6;
- police.mdl: 57 костей, своя анимация @ragdoll лежит в самом MDL
(anim_block == 0); m_anm.mdl: 1563 анимации в models/m_anm.ani (7,1 МБ);
- модель игрока, idle_all_01: из 3147 вершин 1101 сдвинулась между кадрами 0 и
30, высота тела 61 юнит и в покое, и в анимации — не схлопывается.
Движок: AnimData (буферы кадров под Arc), frame_pose, play_model_animation
(мировые позы через родителей, A·B⁻¹ по костям, скиннинг весами вершин);
кости меша ищутся в скелете анимации по именам — скелеты совпадают по именам,
но не по числу костей. Кадры читаются и из .ani, и из самого MDL.
Клиент: вьюмодель играет idle, модель игрока — idle_all_01; добавлен вид со
стороны --third-person (иначе свою модель не увидеть: в первом лице камера
внутри неё). Map(Box<MapArgs>) — против clippy::large_enum_variant.
Все 23 сьюта и 29 картовых тестов зелёные.
- Вода: детект Water-шейдера (/), отдельный полупрозрачный
проход с френелем; поверхность/изнанка по нормали. Белая дыра на месте воды
(2D-скайбокс «вниз») устранена.
- 3D-скайбокс: выбор граней по area листа sky_camera (движок: area bits), а не по
AABB. Disp-грани не попадают в leaf_faces — выбор по листу центра грани; теперь
в скайбоксе есть большая плоскость flatgrass_2 (пропадала — торчала «стена»
бетонного пола). Защита >30% граней = скайбокс не выделяем (gm_flatgrass).
- Порядок: 2D-скайбокс фоном -> 3D-меш (depth Always, без записи) -> мир ->
вода. Скайбокс больше не проступает сквозь дальние стены карты.
- Лайтмапы: блок грани (size+1)^2 с индексом v*width+u; для displacement'ов —
плотная сетка по UV поверхности (CalcDispSurfCoords), а не проекция мира:
убрана «шахматка» теней на рельефе. Скайбокс-меш тоже сэмплит лайтмапы.
- Тесты: gm_flatgrass-диспы живут в скайбоксе (z≈-16000), пороги обновлены.
- docs/RECON.md §12: форматы листьев/граней, лайтмапы, скайбокс, вода.
- engine::model: сборка мешей MDL+VVD+VTX (bind pose, LOD 0), материалы через
cd-каталоги модели, поворот углами Source
- build_world: экземпляры prop_* моделей в общий меш мира (9 инстансов на
gm_construct), кэш моделей и текстур
- 3D-скайбокс: выделение скайбокс-граней (AABB вокруг sky_camera, <30% карты),
сжатие 1/scale вокруг камеры, отдельный пайплайн с глубиной у дальней
плоскости; 2D-скайбокс рисуется только в незакрытых пикселях
- тесты: sky_mesh на gm_construct, пороги дисплейсментов обновлены
