LegacyX Community для CounterStrikeSharp: можливості, налаштування та застереження
Про матеріал
Можливості
LegacyXCommunity — плагін для CS2, який отримує профілі гравців із LEGACY-X API. Він не обчислює EXP чи ранг: результати матчів competitive_result обробляє MatchZy, а рейтинг зберігає Rank system v1. Плагін показує дані гравцям і може відображати ранг у таблиці Tab.
Команди css_rank, css_xp, css_level та css_progress показують ранг, EXP, позицію в рейтингу, прогрес до наступного рангу й статус Pro League. Якщо API не має профілю, гравець побачить повідомлення про відсутність рангу; коли дані недоступні, плагін повідомить, що їх не вдалося отримати.
Для учасників сайту можна виводити тег клану перед рангом, наприклад [WOLF | OPERATOR I]. Тег береться з API, обмежується вісьмома символами й оновлюється після повторного входу гравця або завершення матчу. Для персоналу ранг у тегу замінює роль, яку задає LegacyX-Admin; плагін не змінює позначку MatchZy [TEAM COACH]. Під час активного рейтингового матчу ранг у Tab приховується.
Інші функції: персональне вітання в чаті після входу, команда .discord або !discord для показу запрошення, а також повідомлення про реванш після вбивства суперника, який убив гравця останнім на цій мапі. Реванш не враховує ботів, самогубства й убивства товаришів по команді; повідомлення бачать лише двоє учасників.
Ранг у таблиці гравців
Плагін може встановлювати власні значки рангів у колонці рангу. Для цього використовується тип 12 і значення рейтингу від 19 до 36, пов’язані з файлами skillgroup19.svg … skillgroup36.svg в Workshop-додатку. За README, CS2 не має власних значків із такими номерами. Тип 11 показує EXP як Premier-рейтинг, а тип 0 залишає тільки тег.
Налаштування типу через консоль сервера або RCON: lx_scoreboard_type. Задокументовані значення — 0, 6, 7, 10, 11 і 12; відображення значків для типів, крім описаної конфігурації, може залежати від поведінки сервера. Для власних значків потрібен Workshop-додаток, зібраний і розміщений на сервері.
Застереження: зміна полів рангу на сервері може суперечити правилам Valve. README також попереджає про можливий ризик блокування GSLT. Не вмикайте цю функцію, не оцінивши цей ризик.
Налаштування й безпека
Параметри читаються з центрального CounterStrikeSharp/.env, спільного для плагінів LEGACY-X. Для параметрів таблиці задокументовано lx_scoreboard_type, LEGACYX_COMMUNITY_SCOREBOARD_ICON_OFFSET (значення за замовчуванням 18) і LEGACYX_COMMUNITY_SCOREBOARD_RANKS=false для вимкнення рангів. Тег клану вимикається через LEGACYX_COMMUNITY_CLAN_TAG=false, вітання — через LEGACYX_COMMUNITY_WELCOME=false, реванш — через LEGACYX_COMMUNITY_REVENGE=false. URL Discord за замовчуванням — https://discord.gg/legacyx; його можна змінити параметром LEGACYX_COMMUNITY_DISCORD_URL.
В API надсилається запит до /api/v1/plugin/community/players/:steamId. URL API, ідентифікатор плагіна й scoped-секрет беруться зі спільної конфігурації. Не зберігайте секрети персоналу, ключ Supabase чи облікові дані бази даних у JSON/Cfg плагіна або Git. Файл LegacyXCommunity.json.example містить лише безпечні параметри відображення чату.
Збірка та стан розробки
У репозиторії наведено вихідний код, а не готовий бінарний файл. Для збірки з каталогу проєкту README пропонує:
cd LegacyX-Community
dotnet build -c Release
README зазначає, що підтвердженого сервера поки немає: репозиторій містить підготовку джерел і збірки, а готовий релізний артефакт має пройти перевірену процедуру розгортання. Модель зброї, логіку subclass і режим третьої особи слід спершу перевіряти на тестовому сервері; ці частини не позначені як зібрані чи випробувані. Режим третьої особи за замовчуванням вимкнений і призначений лише для Fun-серверів: для порту 27016 наведено параметр LEGACYX_27016_COMMUNITY_THIRDPERSON=true.
Завантаження
Версія: git-f7886b544165.
ZIP містить вихідні коди; перед встановленням може знадобитися компіляція. Файл плагіна: LegacyX-Community/LegacyXCommunity.cs.




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