Niko Marmeladkov
b9b03abe3b
Батч 3, шаг 1. Фундамент Lua-API: без этих типов Entity:GetPos() не возвращает ничего, с чем можно считать. Проверено тестами через настоящий LuaRuntime, а не голый интерпретатор: скрипт считает теми же глобалами, что и обычный автор в Sandbox. Решения по совместимости: - пропущенные аргументы не бывают ошибкой: Vector() и Vector(1, 2) должны работать, иначе ломается бытовой код Sandbox; - деление на ноль даёт 1, а не inf — inf в позиции пропа отравляет всю геометрию объекта; - NaN из скрипта не доезжает до физики; - компоненты цвета обрезаются в 0..255, а не отвергаются; - Source — левая система координат: нулевые углы смотрят вдоль +X, yaw=90 — вдоль +Y. Найден дефект чтения чисел в mlua 0.11: Value::as_number() различает только Number и молча возвращает None на Integer, а LuaJIT отдаёт целые как Integer. Vector(1, 2, 3) давал Vector(0, 0, 0) — и это выглядело как «арифметика не работает». Собственный value_number() принимает Number, Integer и строку-число. Ещё убрат шум тригонометрии: cos(90°) в f32 равен 6.1e-17, и Angle(0,90,0):Forward() печатал -0.00000004371139 вместо 0. Тестов 17 в glua (было 1), 23 набора по воркспейсу, clippy чист. |
||
|---|---|---|
| .github/workflows | ||
| crates | ||
| docs | ||
| fuzz | ||
| .gitignore | ||
| AGENTS.md | ||
| Cargo.lock | ||
| Cargo.toml | ||
| config.example.toml | ||
| 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 не распространяются вместе с проектом.