No description
Niko Marmeladkov
8a5f43dcd2
Some checks failed
CI / checks (push) Has been cancelled
Спека декодера взята из настоящего 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 картовых тестов зелёные. |
||
|---|---|---|
| .github/workflows | ||
| crates | ||
| docs | ||
| fuzz | ||
| .gitignore | ||
| AGENTS.md | ||
| Cargo.lock | ||
| Cargo.toml | ||
| config.example.toml | ||
| GEMINI.md | ||
| README.md | ||
Source RS (garrysmod-rs)
Клиент Garry's Mod, переписанный с нуля на Rust. Цель — комфортная и красивая игра на сандбокс-серверах с десятками игроков, тысячами сущностей (пропы, констрейны, эффекты) и кучей аддонов, при полной совместимости с реальными серверами эпохи Source 2013 (net protocol 24 + GMod-расширения).
Рабочая цель №1 — сервер ClassicBox (194.147.90.27:24215).
- Имя проекта: Source RS
- Каталог:
~/garrysmod-rs(сессия разработки переведена сюда) - Платформа: Linux x86_64, wgpu/Vulkan. Windows — позже, код кроссплатформенный
- Статус: план зафиксирован, следующий шаг — спринт 0 (см.
docs/PLAN.md§7)
Что чиним (коротко)
Анимации моделей игроков (главный пробел Source.NET), сандбокс-масштаб (кучи пропов/энтити/констрейнов), долгие заходы в игру и на сервер, шейдерные стуттеры и подгрузки, 32-битные лимиты, однопоточность, краши от зловредных аддонов/серверов (Starfall, PAC3 и т.п.), качество картинки.
Документация
| Файл | Содержание |
|---|---|
| docs/PLAN.md | Видение, рамки, принципы, этапы M0–M9, спринт 0, критерии успеха, решения, риски |
| docs/ARCHITECTURE.md | Cargo workspace, крейты, подсистемы, потоки, кэши, конвенции кода |
| docs/PROBLEMS.md | Реестр «болячек» GMod/Source и как каждая решается (+ Принцип сандбокс-масштаба) |
| docs/LUA.md | Lua-рантайм: LuaJIT, sandbox, рельсы API, порядок HUD → Derma → PAC3 → Starfall |
| docs/NETWORK.md | Протокол: netchan, снапшоты, GMod-расширения, Steam, передача файлов, dump/replay |
| docs/RECON.md | Разведка: окружение, сервер, ассеты, референсы, лицензии |
| AGENTS.md | Правила репозитория для агентов/разработчиков |
Что это НЕ такое (первая фаза)
- Не серверный движок: dedicated-сервер и серверный Lua геймодов — вне рамок.
- Не перераспространение ассетов: контент берётся только из локальных установок пользователя.
- Не совместимость с нативными бинарными модулями аддонов (
.dll/.soвнутри addons) — by design.
Правовая заметка
Source SDK 2013 и Source.NET распространяются под Source 1 SDK License. Код оттуда используется только как спецификация; код проекта — собственный. Ассеты Garry's Mod не распространяются вместе с проектом.