Maintenance

Maintenance - это плагин для Minecraft, который позволяет включить режим техобслуживания на сервере. Если вам нужно провести обновление, исправить баги или просто перезагрузить карту, этот плагин не пустит обычных игроков на сервер, пока вы не закончите. Работает на Paper, Velocity, BungeeCord и Sponge - то есть подходит и для одиночных серверов, и для целых прокси-сетей.

В отличие от многих аналогов, Maintenance использует современный формат MiniMessage для оформления текста. Это значит, что вы можете делать цветные градиенты, кликабельные ссылки и прочие красивости прямо в сообщениях. Легаси-формат (§a/&a) тут не поддерживается, так что придётся освоить MiniMessage - благо документация есть, а онлайн-редактор помогает сразу увидеть результат.

Что умеет Maintenance

• Кастомный MOTD и иконка сервера - во время техобслуживания в списке серверов будет отображаться ваше сообщение и специальная иконка.
• Таймеры включения и отключения - можно запланировать, чтобы режим включился через N минут, а потом сам выключился. Или наоборот: включить сейчас, а выключить по таймеру.
• Планировщик - отдельная команда, которая сначала включает обслуживание, а через заданное время выключает. Удобно для плановых работ.
• Переменная %TIMER% - её можно вставить в MOTD, чтобы игроки видели, сколько осталось до окончания работ.
• Белый список на обслуживание - определённые игроки (например, администраторы) могут заходить даже во время техобслуживания.
• Уведомления о попытках входа - если кто-то пытается зайти, админ получит сообщение.
• Почти все сообщения редактируются - через языковой файл можно поменять любой текст. Уже есть переводы на русский, немецкий, французский, испанский, португальский, китайский, итальянский и польский.

Дополнительные фишки на Velocity/BungeeCord

• Можно включить обслуживание только на одном конкретном сервере из прокси-сети, а не на всех сразу. Команда: /maintenance <on/off> <имя_сервера>.
• Если у вас несколько прокси-серверов, можно связать их через MySQL - тогда не придётся вручную включать/выключать режим на каждом.
• Сервер ожидания - при глобальном обслуживании игроков можно отправить на специальный сервер ожидания, а не выкидывать с сообщением.
• Фолбэк-сервер - если конкретный сервер под обслуживанием, игроков с него перекинет на запасной сервер.
• Интеграция с ServerListPlus - при включении обслуживания MOTD от SLP отключается, а при выключении - снова включается, чтобы не было конфликтов.
• PlaceholderAPI на Paper - через аддон MaintenanceAddon можно использовать плейсхолдеры.

Команды

Аргументы в < > обязательны, в [ ] - необязательны.

• /maintenance <on/off> [сервер] - включить/выключить режим обслуживания.
• /maintenance reload - перезагрузить конфиг и иконку.
• /maintenance <add/remove> <игрок/uuid> - добавить/убрать игрока из белого списка.
• /maintenance whitelist - показать список игроков в белом списке.
• /maintenance starttimer [сервер] <минуты> - включить обслуживание через N минут.
• /maintenance endtimer [сервер] <минуты> - включить обслуживание сейчас на N минут.
• /maintenance schedule [сервер] <минуты> <длительность> - включить через N минут на M минут.
• /maintenance aborttimer - отменить текущий таймер.
• /maintenance setmotd <индекс> <1/2> <сообщение> - установить MOTD для режима обслуживания.
• /maintenance motd - показать текущие MOTD.
• /maintenance update - скачать последнюю версию плагина удалённо.
• /maintenance dump - вывести информацию о сервере для баг-репорта.

Права (Permissions)

• maintenance.admin - супер-право, даёт доступ ко всем нижеперечисленным.
• maintenance.bypass - заходить на сервер во время обслуживания.
• maintenance.command - использовать команду /maintenance.
• maintenance.toggle - использовать /maintenance <on/off>.
• maintenance.reload - перезагружать конфиг.
• maintenance.update - обновлять плагин.
• maintenance.timer - управлять таймерами.
• maintenance.whitelist.add / maintenance.whitelist.remove / maintenance.whitelist.list - управление белым списком.
• maintenance.setmotd / maintenance.motd - управление MOTD.
• maintenance.dump - дамп информации.
• maintenance.joinnotification - получать уведомления о попытках входа.

Для прокси-версии есть дополнительные права:

• maintenance.singleserver.bypass.<сервер> - обход обслуживания на конкретном сервере.
• maintenance.singleserver.toggle - включение/выключение на конкретном сервере.
• maintenance.singleserver.timer - таймеры для конкретного сервера.
• maintenance.singleserver.status - просмотр статуса.

Важно: если используете плагин на прокси, права должны быть выданы на прокси, а не на бэкенд-серверах. Лучше всего использовать LuckPerms на прокси.

Конфигурация

Если вы используете Paper-версию, для работы кастомной иконки и сообщений о количестве игроков потребуется ProtocolLib (на Paper 1.12.2+ это не обязательно). Для Velocity/BungeeCord дополнительных плагинов не нужно.

Основные настройки в config.yml:

• maintenance-enabled - включить режим сразу после загрузки.
• proxied-maintenance-servers - список серверов под обслуживанием (только для прокси).
• fallback - фолбэк-сервер для игроков, которых выкинуло с обслуживаемого сервера.
• waiting-server - сервер ожидания при глобальном обслуживании.
• pingmessages - список MOTD-сообщений (выбираются случайно). Можно использовать MiniMessage и %TIMER%.
• enable-timerspecific-messages - отдельные MOTD для периода, когда работает таймер.
• enable-playercountmessage - показывать кастомное сообщение вместо количества игроков.
• custom-maintenance-icon - использовать свою иконку (файл maintenance-icon.png в папке плагина).
• kick-online-players - выгонять игроков при включении обслуживания.
• language - язык сообщений (en, de, fr, pt, es, ru, zh, it, pl).
• mysql - настройки MySQL для синхронизации между прокси.
• continue-endtimer-after-restart - продолжать таймер после перезапуска сервера.
• timer-broadcast-for-seconds - за сколько секунд до события делать оповещения.
• update-checks - проверять обновления.

Языковой файл

Почти все сообщения можно изменить в language.yml. Там же можно настроить префикс, сообщения о кике, уведомления, тексты для таймеров и многое другое. Если какого-то перевода нет, можно добавить свой - автор приветствует вклад сообщества.

Интеграция с ServerListPlus

Если у вас стоит ServerListPlus, Maintenance автоматически отключает его MOTD при включении обслуживания и включает обратно при выключении. Это предотвращает конфликты.

MySQL и несколько прокси

Функция доступна только в Bungee/Velocity-версии. Включив MySQL в конфиге, можно синхронизировать состояние обслуживания между несколькими прокси-серверами. Не нужно вручную включать/выключать на каждом - достаточно сделать это один раз.

Важно знать

• На Paper для полной функциональности (кастомная иконка, сообщения о количестве игроков) нужен ProtocolLib. Без него плагин тоже работает, но часть фишек будет недоступна.
• На прокси права должны быть выданы на прокси, а не на бэкенд-серверах.
• Формат MiniMessage не поддерживает легаси-коды (§a/&a). Используйте онлайн-редактор для создания красивых сообщений.
• Если вы используете таймер и перезагружаете сервер, можно настроить продолжение таймера после перезапуска.

Скачайте плагин Maintenance и забудьте о проблемах с доступом игроков во время технических работ. Гибкие настройки, поддержка прокси и таймеры делают его одним из лучших решений для этой задачи.