LEGACY-X MatchZy: документація плагіна для CS2
About this content
LEGACY-X MatchZy — плагін для competitive-матчів CS2 на CounterStrikeSharp. Він керує життєвим циклом матчу: від перевірки складів і готовності гравців до збереження результатів та переходу на наступну мапу. AdminPlus — окремий плагін, який відповідає за адміністративні дії; його можливості не є частиною MatchZy.
Можливості
- Матч стартує лише за складу рівно 5 CT і 5 T. Усі десять активних людей мають виконати команду готовності; інші варіанти складу не проходять перевірку.
- Після завершення матчу плагін зберігає результат, демо та статистику, виконує м’яке скидання стану й переходить на випадкову встановлену мапу, крім поточної. Жорсткого перезапуску процесу в цьому сценарії немає.
- README також описує можливості upstream MatchZy для practice, pug, scrim, матчів, демо, статистики, бази даних і Get5-сумісних подій.
Вимоги та збірка
Для збірки потрібен .NET 8 SDK. Для сервера вказані Metamod:Source і CounterStrikeSharp. Архів містить вихідний код, а не гарантію готового бінарного файлу. Команди збірки запускаються в каталозі matchzy:
cd matchzy
dotnet build --configuration Release
Очікуваний шлях до артефакту після успішної збірки: matchzy/bin/Release/net8.0/MatchZy.dll.
Встановлення
Помістіть зібраний MatchZy.dll та файли модулів cfg, lang і spawns у відповідні каталоги сервера. README наводить такі шляхи:
csgo/addons/counterstrikesharp/plugins/MatchZy/MatchZy.dll
csgo/cfg/MatchZy/config.cfg
csgo/cfg/MatchZy/*.cfg
csgo/cfg/MatchZy/*.json
Скопіюйте конфігурацію в csgo/cfg/MatchZy/config.cfg, завантажте плагін або перезапустіть його та перевірте startup log на наявність назви LEGACY-X MatchZy.
Налаштування та команди
У production preset cfg/MatchZy/config.cfg наведені такі значення:
legacyx_exact_5v5 true
legacyx_min_players_per_team 2
legacyx_random_map_after_match true
legacyx_map_pool "de_ancient,de_anubis,de_dust2,de_inferno,de_mirage,de_nuke,de_overpass,de_vertigo"
legacyx_map_transition_delay 3.0
matchzy_minimum_ready_required 5
matchzy_allow_force_ready false
У пул додавайте лише встановлені мапи. Поточна мапа виключається з наступного вибору; якщо придатною лишиться лише одна, вона може повторитися. Для production рекомендовано мати щонайменше дві встановлені мапи.
Гравці можуть позначити готовність через .ready у чаті або css_ready у консолі; скасування готовності — css_unready. Для зручності можна надати необов’язковий bind, який не перезаписує наявні прив’язки:
bind ENTER css_ready
Інші корисні команди: css_match_status показує стан MatchZy, css_start запускає матч адміністраторами за умови проходження точних перевірок складу, css_restart перезапускає матч, а css_endmatch завершує його.
Завантаження
Версія: git-f7886b544165.
ZIP містить вихідні коди; перед встановленням може знадобитися компіляція. Файл плагіна: LegacyX-MatchZy/MatchZy.cs.






Comments (0)