CS2-SpecKeeper: документація плагіна для збереження глядачів між мапами
About this content
CS2-SpecKeeper для Counter-Strike 2 запам’ятовує гравців, які спостерігали за грою наприкінці мапи, і повертає їх до команди Spectator після переходу на наступну. Це призначено, зокрема, для адміністраторів, кастерів і гравців в AFK, яких сервер може автоматично призначити до команди.
Можливості
- Плагін веде список глядачів упродовж мапи та зберігає його на диск. Ураховується і перехід до Spectator, який рушій відклав до наступного раунду, зокрема в останньому раунді.
- Після завантаження на новій мапі гравця зі збереженого списку повертають до Spectator. Захист протидіє автоматичному вибору команди, зокрема через
mp_force_pick_time, і переміщенням з боку інших плагінів. - Вибір команди самим гравцем не скасовується: його команда
jointeamзнімає захист від повторного призначення. - Плагін переживає гаряче перезавантаження, вивантаження й повторне завантаження через
css_plugins unload/load, а також перезапуск чи аварійне завершення сервера між мапами. - За потреби гравцям і адміністраторам надсилаються повідомлення. Плагін працює в одному потоці й не використовує асинхронні завдання.
Вимоги
Потрібен виділений сервер Counter-Strike 2 з Metamod:Source та CounterStrikeSharp версії 1.0.369 або новішої (збірки для .NET 10). Для CounterStrikeSharp 1.0.368 і старіших README вказує самостійно зібрати плагін із TargetFramework, встановленим у net8.0, і закріпити пакет на версії 1.0.368.
Встановлення
Інструкція проєкту передбачає ZIP-пакет релізу CS2-SpecKeeper-x.y.z.zip: його вміст потрібно розпакувати до каталогу сервера game/csgo/. У пакеті має бути файл addons/counterstrikesharp/plugins/CS2-SpecKeeper/CS2-SpecKeeper.dll. Після цього перезапустіть сервер або виконайте css_plugins load CS2-SpecKeeper.
У цьому репозиторії надано вихідний код, а не гарантію готового до встановлення DLL. Для збирання з джерел потрібен .NET 10 SDK. У каталозі проєкту виконайте:
dotnet build -c Release
README вказує результат збірки за шляхом bin/Release/net10.0/CS2-SpecKeeper.dll. Згадана команда створює DLL плагіна; компоненти середовища виконання до неї не входять.
Налаштування
Під час першого завантаження створюється addons/counterstrikesharp/plugins/CS2-SpecKeeper/config.json. Коментарі JSON і коми після останніх елементів допускаються, а відсутні параметри заповнюються під час завантаження. Значення за замовчуванням:
Enabled—true: головний перемикач; приfalseплагін не створює знімків, не змінює команди й не надсилає повідомлень.NotifyAdmins—true: сповіщення адміністраторам про збережених глядачів і зведення після їхнього входу.NotifyPlayers—true: повідомлення гравцеві про збережене місце в Spectator.AdminPermission—"@css/generic": прапорець дозволу CounterStrikeSharp для визначення адміністратора.ChatPrefix—"{green}[SpecKeeper]{default}": префікс повідомлень; підтримуються кольорові токени, наприклад{red},{lightblue}і{olive}.SnapshotExpiryMinutes—60: знімки старші за вказаний час відкидаються; значення0вимикає строк дії.KeepUnassignedPlayers—false: визначає, чи зберігати гравців, які на момент завершення мапи ще не обрали команду.
Блок _help у файлі містить пояснення параметрів і генерується заново під час кожного завантаження. Після редагування конфігурації виконайте css_speckeeper_reload або перезавантажте плагін.
Команди
css_speckeeper— для адміністратора з дозволомAdminPermissionабо серверної консолі. Показує поточних глядачів і список перенесених гравців: кого вже залишено в Spectator, а хто ще не повернувся.css_speckeeper_reload— для@css/rootабо серверної консолі. Перечитуєconfig.jsonбез перезавантаження плагіна.
Збереження діє рівно одну мапу: після її завершення формується новий знімок, який замінює попередній. Стан зберігається у файлі speckeeper_state.json у каталозі плагіна.
Завантаження
Версія: v1.1.0.
ZIP містить вихідні коди; перед встановленням може знадобитися компіляція. Файл плагіна: src/SpecKeeperPlugin.cs.






Comments (0)