LegacyX-Admin: документація адміністративного модуля для CounterStrikeSharp
О материале
LegacyX-Admin — адміністративний модуль LEGACY-X для CounterStrikeSharp, що походить від CS2-AdminPlus і адаптований до центральної конфігурації LEGACY-X. У README вказано, що upstream-проєкт поширюється за ліцензією MIT; файл LICENSE збережено, а авторство upstream зазначається в метаданих модуля.
Можливості
Модуль централізовано обслуговує адміністративні меню, команди модерації з префіксом css_, бани, mute й gag, скарги, голосування, резервування слотів і керування гравцями. README застерігає не запускати паралельно старий мінімальний міст LEGACY-X AdminPlus або інший плагін, який використовує ті самі команди й файли стану.
Меню !admin відкриває розділи Staff, Players, Server і Bans. Команда !cc призначена творцям контенту: вона показує Fun-меню з командами, дозволеними для ролі на сайті. Зміни ролей сервер має підхоплювати протягом хвилини. README позначає цю функцію як таку, що ще не зібрана чи не перевірена в грі.
Набір розважальних команд включає, зокрема, !launch <target> [power] (потужність за замовчуванням 600, допустимо 100–1500) та !size <target> <0.3-3> і !unsize <target>. Для багатьох таких команд потрібен дозвіл @css/slay; README також описує !burn, !bounce, !lowgrav, !fling, !blink, !tprandom і !drop. Перелік містить і ефекти на кшталт !jetpack, !doublejump, !aura та !chaos. Частина цих можливостей ще не запускалася в грі, а для окремих команд README прямо радить спочатку перевірити їх на тестовому сервері.
Вимоги та конфігурація
Налаштування модуль читає з CounterStrikeSharp/.env через LegacyX.Shared.Configuration. Основні параметри:
LEGACYX_ADMIN_ENABLEDвмикає або вимикає модуль до реєстрації команд і подій.LEGACYX_ADMIN_CALL_CHANNEL_ENABLEDкерує сповіщеннями про гравецький!admin/ звіт у Call-канал Discord.LEGACYX_ADMIN_CALL_CHANNEL_WEBHOOKзадає центральний webhook; його не слід зберігати в локальному JSON плагіна.LEGACYX_ADMIN_CALL_CHANNEL_MENTIONзадає необов’язкову згадку ролі;@everyoneі@hereвідхиляються.LEGACYX_SERVER_ADDRESS— спільна адреса сервера, що додається лише до Call-сповіщення.LEGACYX_ADMIN_CENTRAL_BANS_ENABLEDвмикає перевірку центрального списку банів під час підключення та повторно кожніLEGACYX_ADMIN_CENTRAL_BANS_SWEEP_SECONDS; інтервал за замовчуванням — 30 секунд. Для перевірки потрібніLEGACYX_ADMIN_API_BASE_URL,LEGACYX_ADMIN_PLUGIN_SECRETі токен зі scopebans:read. Якщо API недоступний, перевірка працює за принципом fail-open.
Під час входу API також перевіряє авторизацію на legacyx.cc і обмеження за вихід із рейтингових матчів. Параметри LEGACYX_ADMIN_REQUIRE_LOGIN=false та LEGACYX_ADMIN_ENFORCE_LEAVE_COOLDOWN=false вимикають відповідні перевірки. Співробітників із правом @css/generic не видаляють із сервера; за недоступності API гравців також не видаляють.
Бани та команди
Бани зберігаються в базі LEGACY-X і застосовуються на всіх серверах; локальні banned_user.cfg та banned_ip.cfg не використовуються. Через консоль або RCON команди css_ban і css_unban приймають SteamID64, STEAM_X:Y:Z або [U:1:N] для гравців поза сервером; css_unban також приймає IP-адресу.
README вказує, що після видачі бану гравця заморожують і позбавляють зброї, показують червоний екран із тривалістю та причиною на чотири секунди, а потім від’єднують. Забаненого не пустить повторно навіть у цей проміжок. Root-користувачам доступна команда !cheats [0|1]: без аргументу вона перемикає sv_cheats; наступна розминка повертає значення до 0. Команда !cvar sv_cheats залишається заблокованою.
Збирання та застереження
Для збирання вихідного коду README наводить команду:
dotnet build LegacyX-Admin.csproj --configuration Release
Репозиторій містить вихідні файли, а не готову DLL: він самостійно не встановлює сервер CS2, не створює робочий файл середовища й не розгортає плагін. Є також розбіжність у документації: README описує Discord-функцію як обмежену Call-сповіщеннями, тоді як у AdminPlus.cs наявні виклики надсилання журналів чату та підключень/відключень. Перед розгортанням цю поведінку варто звірити з фактичною конфігурацією Discord-модуля.
Завантаження
Версія: git-f7886b544165.
ZIP містить вихідні коди; перед встановленням може знадобитися компіляція. Файл плагіна: LegacyX-Admin/AdminPlus.cs.




Комментарии (0)