Spyglass (Спайгласс, CapyBara_Man69)

Плагин для серверов Майнкрафт, связывающий сервер с Discord: позволяет создавать Discord-команды для выполнения команд на сервере и передавать в выбранный канал журнал введённых команд. Подходит для управления сервером, модерации и наблюдения за действиями игроков.

Возможности

Discord-команды задаются в config.yml: ключ определяет название и аргументы команды, а minecraft-command — выполняемую команду Майнкрафт. Одна команда может запускать несколько команд по порядку, иметь задержку, выполняться от имени консоли или игрока, отвечать скрыто и ограничиваться ролями, пользователями либо каналами Discord.

Поддерживаются аргументы string, integer, number, boolean, user, channel и role, фиксированные варианты выбора, автодополнение игроков онлайн и аргумент с текстом до конца строки.

Мониторинг передаёт команды игроков, консоли, RCON и Discord. Для него доступны плейсхолдеры игрока, координат, мира, здоровья, пинга, времени, команды, пользователя Discord и состояния сервера. Команды login, register и личные сообщения исключены из журнала по умолчанию; можно настроить списки исключений, белый список и игроков, чьи команды не передаются.

Плагин проверяет конфигурационные файлы до применения: при ошибке YAML текущие настройки продолжают работать, а в консоль выводятся строка, столбец и подсказка по исправлению. Текст сообщений оформляется в messages.yml через MiniMessage.

Команды

• /spyglass reload — перезагрузить config.yml и messages.yml;
• /spyglass status — показать состояние соединения с Discord, мониторинга и предупреждения конфигурации;
• /spyglass commands — вывести настроенные Discord-команды;
• /spyglass test — отправить проверочное сообщение в канал мониторинга;
• /spyglass help — показать справку;
• /sg и /glass — сокращения для /spyglass.

Права

• spyglass.admin — доступ ко всем подкомандам;
• spyglass.reload — /spyglass reload;
• spyglass.status — /spyglass status;
• spyglass.commands — /spyglass commands;
• spyglass.test — /spyglass test;
• spyglass.monitor.bypass — команды игрока не передаются в Discord.

Настройка

Для журнала команд включите command-monitor.enabled, укажите command-monitor.channel-id и шаблон command-monitor.format в config.yml. Для работы Discord-команд в том же файле понадобятся токен бота и идентификатор сервера Discord.

Требования

Плагин работает на Bukkit, Spigot, Paper и Purpur. Требуются Java 21 или выше, а также бот Discord с токеном.