CommandGuard
CommandGuard керує тим, які команди гравці бачать і можуть виконувати на вашому сервері. Він працює на двох рівнях одразу:
- Блокує команди — заборонена команда не виконується, а замість неї спрацьовує налаштована дія (повідомлення, звук, title, команда консолі, ефект зілля).
- Фільтрує tab-complete — у списку автодоповнення гравець бачить лише ті команди, які йому дозволені. Прихованих команд немає навіть у підказках.
Працює на окремому сервері Spigot/Paper і на проксі Velocity.
Платформи
| Платформа | Версії |
|---|---|
| Paper / Spigot | 1.16.5+ |
| Velocity | 3.x |
Мінімальна версія Java залежить від платформи: Spigot — Java 17, Velocity — Java 21.
Spigot чи Velocity — хто за що відповідає
Кожна версія працює зі своїм набором команд:
- Spigot (бекенд) відповідає за команди бекенд-сервера. Блокує будь-який ввід
гравця за списком із
config.ymlі фільтрує tab-complete для команд, зареєстрованих на цьому сервері. - Velocity (проксі) відповідає лише за команди проксі (ті, що зареєстровані на самому Velocity). Команди бекенда проксі не чіпає — ними займається Spigot.
Якщо плагін стоїть і там, і там, вони не дублюють роботу, а доповнюють одна одну. Докладніше про сумісну роботу — у розділі Робота в мережі.
Основні можливості
- Фільтрація tab-complete — гравець бачить лише дозволені йому команди.
- Блокування команд із діями:
message,title,sound,console_command,give_potion_effect. - Режим білого списку — дозволити лише певні команди, решту заблокувати.
- Групи прав із пріоритетом, наслідуванням (
extends) і злиттям груп однакового пріоритету. - Групи для окремих серверів (
servers) — різні списки tab на різних бекендах (тільки проксі). - TabSync між серверами — проксі надсилає дозволений список проксі-команд на бекенд через plugin messaging.
- Захист від spy-клієнтів — фільтрує сирі пакети TAB_COMPLETE, щоб чит-клієнти не могли дізнатися приховані команди.
- Багатомовність — у комплекті
en_ENіru_RU, свої мови додаються вplugins/CommandGuard/lang/. - Блокування команд із двокрапкою — за бажанням блокує всі обходи виду
namespace:command.
Швидка навігація
- Встановлення — як поставити і запустити плагін.
- Конфігурація — розбір
config.yml. - Групи прав — пріоритети, наслідування, per-server.
- Робота в мережі — TabSync між проксі та бекендом.
- Команди — список команд.
- Права — список дозволів.
- Локалізація — мовні файли та префікс.
- API для розробників — події та доступ до tab-груп з іншого плагіна.