No description
Find a file
Niko Marmeladkov b991cc59f1 lua: мост к движку — Entity(), ents.* работают с живым миром
Батч 3, шаг 2. Крейт glua не зависит от engine: поведение отдаётся через
трейт Host, реализация которого живёт в клиенте. Иначе был бы цикл
зависимостей и Lua-слой нельзя было бы тестировать в одиночку.

Мир переведён в Rc<RefCell<World>> — скрипт обращается к нему из хуков в
любой момент. Все обращения через try_borrow: пересечение заимствований
даёт panic, а падать из-за скрипта клиент не должен.

Проверено измерением на gm_construct: ents.GetAll() возвращает 1227
сущностей, ents.GetByClass('prop_physics') читает позицию.

Найден и исправлен рассинхрон: move_prop обновлял позу экземпляра пропа,
но не запись в пуле сущностей. Lua читал z = -64, пока физика уже опустила
проп на z = -84 — «данные» и «картинка» разошлись, и заметить это можно
было только глазами. Теперь поза пишется в оба места всегда, даже без
модели: проп без модели всё равно стоит правильно, он просто не рисуется.
Возвращаемое значение move_prop теперь означает именно «геометрия
пересчитана».

После правки Lua читает z = -84.15848, физика даёт -84.15847778320313 —
совпадение до последнего бита.

Тест на паникующий хост: скрипт получает «невалидно» вместо падения.

Тестов 24 в glua, 56 в engine, 23 набора по воркспейсу, clippy чист.
2026-10-13 12:57:01 +03:00
.github/workflows sprint 0: workspace, tier/fs/math, VPK v1/v2 с CRC, окно SDL3+wgpu на Vulkan 2026-10-11 22:47:09 +03:00
crates lua: мост к движку — Entity(), ents.* работают с живым миром 2026-10-13 12:57:01 +03:00
docs lua: мост к движку — Entity(), ents.* работают с живым миром 2026-10-13 12:57:01 +03:00
fuzz sprint 0: workspace, tier/fs/math, VPK v1/v2 с CRC, окно SDL3+wgpu на Vulkan 2026-10-11 22:47:09 +03:00
.gitignore docs: план Source RS — этапы, архитектура, проблемы, Lua, сеть, разведка 2026-10-11 22:25:36 +03:00
AGENTS.md docs: план Source RS — этапы, архитектура, проблемы, Lua, сеть, разведка 2026-10-11 22:25:36 +03:00
Cargo.lock engine: физика на Rapier3D — пропы падают, сталкиваются и засыпают 2026-10-13 12:36:51 +03:00
Cargo.toml engine: физика на Rapier3D — пропы падают, сталкиваются и засыпают 2026-10-13 12:36:51 +03:00
config.example.toml sprint 0: workspace, tier/fs/math, VPK v1/v2 с CRC, окно SDL3+wgpu на Vulkan 2026-10-11 22:47:09 +03:00
README.md docs: план Source RS — этапы, архитектура, проблемы, Lua, сеть, разведка 2026-10-11 22:25:36 +03:00

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 не распространяются вместе с проектом.