zMuzy WeaponPhysics: документация плагина для физики выброшенного оружия CS2

Возможности

zMuzy WeaponPhysics — плагин CounterStrikeSharp для CS2, который добавляет реакцию лежащего на земле оружия на попадания. Выстрел рядом с предметом отбрасывает его, а удар ножом может подбросить его вперёд. C4, ножи, гранаты и другие вспомогательные предметы не обрабатываются как цели. Плагин можно использовать отдельно: zMuzy JailBreak не является обязательной зависимостью, хотя в README упоминается сценарий Gun Toss.

Код подтверждает, что толчки от пуль и ножа можно включать по отдельности. На динамику также влияют вертикальный импульс, ограничение скорости и задержка между толчками одного и того же оружия.

Требования

• Выделенный сервер CS2 с Metamod:Source 2.0.
• CounterStrikeSharp версии 1.0.379 или новее, пакет with-runtime (.NET 10).

Установка

1. Скачайте архив MuzyWeaponsPhysics-vX.Y.Z.zip из последнего релиза.
2. Распакуйте его в game/csgo/. Файл плагина должен находиться по пути game/csgo/addons/counterstrikesharp/plugins/MuzyWeaponsPhysics/MuzyWeaponsPhysics.dll.
3. Перезапустите сервер или загрузите плагин из консоли сервера командой css_plugins load MuzyWeaponsPhysics.

При первом запуске создаётся конфигурация game/csgo/addons/counterstrikesharp/configs/plugins/MuzyWeaponsPhysics/MuzyWeaponsPhysics.json.

Настройки

По умолчанию общий переключатель и оба типа толчков включены. Основные параметры и начальные значения:

{
  "Enabled": true,
  "EnableBulletBoost": true,
  "EnableKnifeBoost": true,
  "BulletImpactRadius": 52,
  "BulletBoostSpeed": 1150,
  "KnifeReach": 125,
  "KnifeLateralTolerance": 48,
  "KnifeBoostSpeed": 1450,
  "VerticalBoost": 65,
  "MaxWeaponSpeed": 1700,
  "ImpulseCooldownSeconds": 0.05
}

Диапазоны настроек соответственно следующие: BulletImpactRadius — 8–256; BulletBoostSpeed — 50–4000; KnifeReach — 16–256; KnifeLateralTolerance — 8–160; KnifeBoostSpeed — 50–4000; VerticalBoost — 0–1000; MaxWeaponSpeed — 100–5000; ImpulseCooldownSeconds — 0–1. Значения за пределами диапазона обрезаются при загрузке конфигурации.

Сборка

Для сборки требуется .NET 10 SDK. В каталоге проекта выполните:

dotnet build MuzyWeaponsPhysics.csproj -c Release

В README также описана автоматическая сборка GitHub Actions после отправки тега, начинающегося с v, и добавление ZIP-архива к релизу. Репозиторий с исходным кодом сам по себе не является готовым бинарным плагином. Лицензия проекта — GPL-3.0.

Загрузка

Версия: v1.0.0.

ZIP содержит исходный репозиторий; готовая сборка не гарантируется. Файл плагина: MuzyWeaponsPhysicsPlugin.cs.