Мод Clientside Ragdoll Collision для Garry’s Mod

Мод Clientside Ragdoll Collision добавляет клиентскую коллизию для регдоллов игроков и NPC, позволяя им физически взаимодействовать с серверными объектами без использования серверных регдоллов и падения производительности. Аддон создаёт иллюзию того, что клиентские регдоллы сталкиваются с картой и пропами, используя вспомогательные клиентские сущности. Особое внимание уделено тому, чтобы всё работало локально у игрока и не нагружало сервер или других пользователей.

Основные возможности

• Поддержка большинства vphysics‑сущностей: prop_physics, prop_dynamic, func_physbox, func_brush, func_door и других, которые включены в белый список по умолчанию.
• Вся логика работает на стороне клиента, без серверных затрат и без влияния на других игроков.
• Набор настроек и команд для тонкой регулировки производительности под слабые и мощные ПК (значения по умолчанию ориентированы на слабые системы).
• Включение/выключение аддона в реальном времени через консоль.
• Возможность добавлять и удалять классы сущностей в локальный белый список коллизий (настройки сохраняются на диск и подгружаются при следующем запуске).
• Серверный чёрный список, позволяющий владельцам серверов ограничить, с чем могут сталкиваться регдоллы.

Аддон не может работать на мультиплеер‑сервере, если тот сам его не использует: по умолчанию он не активен без серверной части. В качестве исключения предусмотрен инжектируемый файл csrd_ragcollide_injectable.lua для серверов с sv_allowcslua 1, где можно запускать его как чистый визуальный эффект без влияния на геймплей.

Команды

• csrd_enable — включить или отключить работу аддона.
• csrd_maxcollides — максимальное число клиентских призрачных коллизий одновременно.
• csrd_scanradius — радиус поиска серверных объектов для создания коллизий вокруг одного регдолла.
• csrd_relevancedist — максимальная дистанция, на которой регдолл может порождать коллизии.
• csrd_rawteleportdist — расстояние коррекции, при котором коллизионная сущность телепортируется к своему объекту (если отключён CSC).
• csrd_collidemass — масса клиентских коллизионных сущностей; высокие значения делают их более устойчивыми, но могут вести к нестабильному поведению.
• csrd_scancooldown — задержка между сканами для разных клиентских сущностей.
• csrd_priority — способ приоритезации объектов для коллизии: none, distance или bounds.
• csrd_method — используемый метод сканирования карты для поиска объектов.
• csrd_debugdraw — визуализация клиентских коллизий (полезно для отладки и оценки нагрузки).

Управлению теневыми вычислительными ресурсами

• csrd_csc — включает/выключает режим Compute Shadow Control (по умолчанию включён).
• csrd_csc_errorcorrect — расстояние, на котором клиентская “тень” будет телепортирована к своему серверному объекту.
• csrd_csc_secondstoarrive — время, за которое клиентская коллизия должна “догнать” соответствующую серверную сущность (нельзя ставить 0).
• csrd_csc_maxspeed — максимальная скорость перемещения клиентской коллизии.
• csrd_csc_damping — “жёсткость” управления: высокое значение даёт точное следование, низкое — более пружинящее поведение.

Дополнительные команды

• csrd_flushcollides — удаляет все текущие коллизии, полезно при сбоях и утечках памяти.
• csrd_whitelist — выводит список классов сущностей, которые в данный момент в белом списке.
• csrd_whitelist_add lassname> — добавляет указанный класс сущностей в белый список (использовать аккуратно).
• csrd_whitelist_remove lassname> — удаляет класс из белого списка.
• csrd_blacklist — показывает все заблокированные классы и причину блокировки.

Аддон создан как визуальное улучшение и не даёт заметного игрового преимущества: коллизии видит только владелец клиента, и они не влияют на физику для других игроков. Автор отмечает, что это его первый серьёзный Lua‑проект и просит сообщать об ошибках и предлагать улучшения.