EasyCommandBlocker

EasyCommandBlocker - это плагин для серверов Minecraft, который решает одну из самых частых проблем администраторов: как запретить игрокам использовать определённые команды и убрать их из автодополнения (того самого /). Без такого инструмента любой игрок может случайно или намеренно выполнить команды вроде /plugins, /version или /pl, что раскрывает информацию о сервере и может привести к нежелательным последствиям.

Зачем нужен EasyCommandBlocker?

На любом сервере Майнкрафт есть команды, которые не должны быть доступны обычным игрокам. Встроенные средства ванильного Minecraft не позволяют гибко управлять этим. EasyCommandBlocker даёт полный контроль: вы сами решаете, какие команды блокировать, какие разрешить, и что будет, если игрок попробует их использовать.

Особенности плагина

• Блокировка команд - задайте список команд, которые будут недоступны
• Список разрешённых команд - можно сделать белый список, разрешив только определённые команды
• Скрытие из автодополнения - заблокированные команды не будут показываться при нажатии Tab
• Блокировка colon-команд - запрет команд с двоеточием (например, /bukkit:pl)
• Показ только определённых команд в tab completion (для версий 1.13+)
• Разные действия при попытке использовать заблокированную команду - можно отправить сообщение, показать title, проиграть звук, наложить эффект зелья или выполнить консольную команду
• Группы команд с разными действиями - для разных наборов команд можно настроить разные реакции
• Работа с ViaVersion, ViaBackwards и ViaRewind - корректно скрывает автодополнение для версий 1.8-1.21
• Поддержка Waterfall и Velocity - блокирует прокси-команды и скрывает автодополнение
• Совместимость с 1.8+

Как это работает?

EasyCommandBlocker перехватывает выполнение команд на сервере и проверяет их по вашему конфигу. Если команда в списке заблокированных - срабатывает заданное действие. При этом из автодополнения эти команды тоже исчезают, так что игроки даже не будут знать об их существовании.

Установка и настройка

Для Spigot/Paper серверов:

Просто скачайте плагин EasyCommandBlocker и поместите его в папку plugins. Плагин будет блокировать команды самого сервера.

Для Waterfall и Velocity:

Скачайте плагин и поместите в папку plugins на прокси. Плагин будет блокировать только прокси-команды. Можно использовать плагин одновременно и на прокси, и на игровых серверах.

Конфигурация config.yml

В конфиге можно настроить:

• Группы для автодополнения - показывать только определённые команды определённым игрокам (по permission)
• Действия по умолчанию для заблокированных команд
• Список команд для блокировки
• Белый список команд (если включить опцию use_commands_as_whitelist)
• Блокировку colon-команд
• Индивидуальные действия для конкретных команд

Пример настройки действий:

blocked_command_default_actions:
  - 'message: &8[&b&lECB&8] &cУ вас нет прав на эту команду.'
  - 'playsound: BLOCK_NOTE_BLOCK_PLING;10;0.1'
  - 'title: 20;40;20;&cЧто ты делаешь?;&7Не используй эту команду!'

Команды и разрешения

Команды:

• /easycommandblocker reload (алиас: /ecb reload) - перезагружает конфиг

Разрешения:

• easycommandblocker.admin - доступ к /ecb reload
• easycommandblocker.tab.<группа> - доступ к определённой группе автодополнения
• easycommandblocker.bypass.tab - полный обход фильтров автодополнения
• easycommandblocker.bypass.commands - полный обход блокировки команд

Важно знать

• В опции tab можно отображать только те команды, которые зарегистрированы на сервере и на которые у игрока есть права. Это ограничение Minecraft.
• При тестировании обязательно снимите с себя OP, так как операторы обходят все настройки.
• Плагин не работает на BungeeCord, только на Waterfall и Velocity.
• Если вы используете ECB и на прокси, и на бэкенде, включите опцию is_network: true.
• Для поддержки версий 1.12- требуется ProtocolLib и опция legacy_support: true.

API для разработчиков

EasyCommandBlocker предоставляет небольшое API с событием CommandBlockedEvent:

@EventHandler
public void onBlockedCommand(CommandBlockedEvent event){
    Player player = event.getPlayer();
    String command = event.getCommand();
    String fullCommand = event.getFullCommand();
}

Если вы собираете сервер Майнкрафт и хотите защитить его от любопытных глаз - EasyCommandBlocker станет отличным помощником. Он лёгкий, современный и работает на актуальных версиях игры. Скачайте плагин EasyCommandBlocker и настройте его под свои нужды.