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.