CommandOverride: Создание кастомных команд в Minecraft без программирования
Администрирование сервера Minecraft часто требует быстрой реакции на запросы игроков: показать правила, дать ссылку на Discord или просто ответить на частый вопрос. Писать для этого отдельные плагины на Java — долго и сложно. CommandOverride решает эту проблему элегантно: он позволяет создавать собственные команды с любыми сообщениями и даже алиасы для существующих команд, вообще не касаясь кода. Всё настраивается через конфигурационный файл, а богатый набор переменных делает вывод динамическим.
Что такое CommandOverride?
Это Bukkit-плагин, разработанный TheBusyBiscuit, который даёт администраторам инструмент для быстрого создания информационных и вспомогательных команд. Вместо того чтобы изучать Java API, вы просто описываете нужное поведение в YAML-конфиге. Плагин обрабатывает введённую игроком команду и отправляет заранее заданные сообщения, выполняет действия от лица игрока или консоли, а также поддерживает цветовые коды. Типичный сценарий — команда /vote, которая выводит ссылки на голосование, или /rules с правилами сервера.
Основные возможности
- Создание любых команд без Java. Достаточно добавить секцию в
config.yml. - Поддержка цветовых кодов. Используйте символ
&для форматирования текста. - Алиасы для существующих команд. Можно сделать короткую команду, которая запускает другую.
- Динамические переменные. В сообщения подставляются имя игрока, количество онлайна, аргументы и многое другое.
- Условное выполнение. Проверка прав, мира, длины аргументов.
- Задержки и случайный выбор. Скрипты с
WAIT,RANDOMиBREAK. - Звуки и широковещательные сообщения. Проигрывание звуков, отправка сообщений определённым группам.
- Интеграция с Vault и PrisonGems. Переменные для префикса, суффикса, баланса и гемов.
Установка и настройка
Скачайте последнюю версию CommandOverride с официальной страницы плагина. Если вы предпочитаете максимально простой способ управления модами и плагинами, обратите внимание на лаунчер foxygame.net — он позволяет устанавливать дополнения прямо из меню, что экономит время и избавляет от ручного копирования файлов. После загрузки поместите JAR-файл в папку plugins сервера и перезапустите его. В папке плагина появится config.yml, где уже есть примеры команд. Основная команда для перезагрузки конфига — /reloadcommands (требует право CommandOverride.reload).
Структура конфигурации
Каждая кастомная команда описывается в отдельной секции. Можно задать несколько сообщений, которые будут отправлены последовательно, или использовать специальные синтаксисы для выполнения действий. Все доступные переменные и синтаксисы подробно описаны ниже.
Переменные и синтаксис
CommandOverride предоставляет мощный язык шаблонов, который позволяет делать сообщения живыми и контекстно-зависимыми. Переменные делятся на базовые, условные, управляющие и плагинозависимые.
Базовые переменные
<player>— имя игрока, выполнившего команду.<players_online>— текущий онлайн сервера.<players_max>— максимальное количество слотов.<rplayer>— имя случайного игрока на сервере.[online: <permission>]— список всех игроков с определённым правом.[rplayer <permission>]— случайный игрок с указанным правом.<arg (index)>— аргумент команды (нумерация с нуля).<args (start) - (end)>— диапазон аргументов, объединённых пробелом.[unicode: <hex>]— вставка символа Unicode по шестнадцатеричному коду.
Условные синтаксисы
[permission: <perm>]— следующий текст только при наличии права.[!permission: <perm>]— следующий текст только при отсутствии права.[world: <world_name>]— выполнение, если игрок в указанном мире.[arglength smaller than X]— условие на количество аргументов меньше X.[arglength at least X]— условие на количество аргументов не менее X.
Действия и управляющие конструкции
command:/<command>— выполнение команды от имени игрока.unsafe-command:/<command>— выполнение команды в обход проверок CommandOverride.op-command:/<command>— выполнение команды с правами оператора.console:/<command>— выполнение команды от имени консоли.broadcast:<message>— отправка сообщения всем игрокам.broadcast[<perm>]:<message>— широковещательное сообщение только для игроков с правом.message[<player>]:<message>— личное сообщение конкретному игроку.playsound <player/all> <sound> <volume> <pitch>— воспроизведение звука.WAIT <seconds>— пауза в секундах перед продолжением.WAIT-T <ticks>— пауза в тиках (1 тик = 1/20 секунды).BREAK— остановка обработки последующих строк.BREAK <iterations>— остановка после указанного числа итераций.RANDOM <amount> <total>— случайный выбор N строк из следующих M.[chance: <percent>]— вероятность для строки в комбинации сRANDOM.
Плагинозависимые переменные
<rank-prefix>— префикс группы прав (требуется Vault).<rank-suffix>— суффикс группы прав (Vault).<money>— баланс игрока (Vault).<gems>— количество гемов (PrisonGems).
Примеры использования
Предположим, нужно создать команду /links, которая показывает ссылки на соцсети сервера. В конфиге это выглядит так:
links:
message:
- '&6Наши ссылки:'
- '&aСайт: &fhttps://example.com'
- '&aDiscord: &fhttps://discord.gg/example'
Если требуется команда, которая показывает онлайн только определённой группе, используем условие:
staffonline:
message:
- '&eОнлайн администрации: [online: staff.admin]'
А вот пример с задержкой и звуком — команда /alert, которая через 5 секунд оповещает всех игроков и проигрывает звук:
alert:
message:
- '&cВнимание! Через 5 секунд произойдёт важное событие!'
- 'WAIT 5'
- 'broadcast:&4Событие началось!'
- 'playsound all BLOCK_NOTE_PLING 1 1'
CommandOverride также отлично справляется с созданием алиасов. Например, чтобы команда /spawn телепортировала игрока на спавн через плагин Essentials, достаточно написать:
spawn:
message:
- 'command:/spawn'
Благодаря гибкой системе переменных и условных операторов можно реализовать сложные сценарии без единой строки Java-кода. Плагин активно использует автообновление (отключается в конфиге) и систему метрик, которую при желании можно выключить в plugins/Plugin Metrics/config.yml.
Заключение
CommandOverride — незаменимый инструмент для администраторов, которые ценят время и хотят быстро реагировать на потребности сообщества. Он убирает барьер в виде необходимости программирования, позволяя сосредоточиться на содержательной части. Будь то информационные команды, голосовалки или сложные цепочки действий — плагин справляется на отлично. А благодаря открытому исходному коду на GitHub любой желающий может внести вклад в развитие проекта или адаптировать его под уникальные нужды своего сервера.