Плагин Maintenance: поддерживайте ваш сервер Minecraft в пор

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

Maintenance - это плагин, который позволяет мягко перевести ваш сервер в режим обслуживания. Вместо грубого разрыва соединения игроки видят кастомное сообщение, объясняющее, почему сервер временно недоступен, когда он снова станет доступен, и, возможно, крутой иконку сервера. Некоторые из ваших доверенных администраторов и тестирующих все еще могут присоединиться и работать, пока все остальные заблокированы. Это разница между профессионализмом и... исчезновением.

Что делает Maintenance для вашего сервера

В основе своей этот плагин позволяет включать и выключать режим обслуживания. Но «включить режим обслуживания» недостаточно точно передает, что происходит под капотом.

Когда вы включаете режим обслуживания, сервер остается в рабочем состоянии - вы не выключаете его. Игроки, пытающиеся подключиться, видят кастомное сообщение вместо ошибки таймаута. Вы можете полностью настроить это сообщение, заменить иконку сервера, установить автоматический таймер для повторного включения сервера в определенное время, и предоставить белый список игроков, которые все еще могут присоединиться. Представьте это как «Не беспокоить» знак для вашего сервера, только этот знак интерактивен и информативен.

Он работает на нескольких типах серверов: Paper (самый популярный выбор для производственных серверов), Spigot, BungeeCord для прокси-настроек, Sponge и Velocity. Если вы управляете сетью серверов за прокси, вы даже можете связать их через Redis, чтобы одна команда переключала режим обслуживания на всех экземплярах.

Почему вы бы использовали это

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

Без Maintenance вы просто отключаете сервер. Игроки появляются обратно у себя дома на следующий день, озадаченные, думая, что сервер мертв. Некоторые могут предположить, что он заброшен и не вернутся в течение недели. С включенным Maintenance они видят: «Сервер отключен для срочного исправления ошибок. Включится через 30 минут». Внезапно они знают, что происходит и когда сервер снова станет доступен. Некоторые даже зайдут обратно через 30 минут именно потому, что знают, когда он вернется.

Теперь масштабируйте это до более крупного сервера с более чем 100 одновременными игроками в часы пик. Вы применяете патч безопасности. Вам нужно, чтобы каждый игрок отключился чисто, чтобы обновление не испортило данные. Режим обслуживания позволяет вам поставить в очередь сообщение, которое предупреждает игроков за 5 минут до отключения, а затем принудительно отключает их, когда таймер сработает. Гораздо менее хаотично, чем крах.

И если вы управляете сетью серверов - скажем, Skyblock, Survival и Creative, стоящих за BungeeCord - вы можете применить режим обслуживания только к серверу Skyblock без влияния на остальные. Ваши игроки все еще могут играть в Creative, пока Skyblock исправляется.

Запуск работы

Установка проста. Скачайте соответствующий JAR для вашего типа сервера (Paper, Velocity и т.д.) и положите его в папку плагинов.

cd /path/to/server/plugins
wget https://github.com/kennytv/Maintenance/releases/download/5.0.0/Maintenance-Paper-5.0.0.jar

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

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

Как только вы настроите, вы можете переключать режим обслуживания простой командой: `/maintenance on` или `/maintenance off`. Если вы используете прокси вроде BungeeCord, вы можете применить это к конкретным серверам: `/maintenance on survival-1`, чтобы включить режим обслуживания только для вашего основного сервера Survival.

Важные функции

За пределами основного функционала, Maintenance имеет несколько выдающихся функций, достойных внимания.

Автозадержки. Вы можете установить таймер, который автоматически включит сервер обратно через определенное время. Запланировали 1-часовой период обслуживания? Установите таймер и забудьте - сервер включится автоматически. Полезно, когда вы работаете поздно и не хотите вспоминать, чтобы переключить режим.

Белый список. Вы можете предоставить доступ к конкретным игрокам во время обслуживания, пока все остальные заблокированы. Идеально для того, чтобы ваши основные администраторы и строители могли продолжать работать над исправлениями или подготовкой событий. Белый список отдельен от обычного белого списка сервера, поэтому он чисто интегрируется.

Динамические сообщения с переменными. Плагин поддерживает плейсхолдеры переменных в сообщении об обслуживании. Используйте `%TIMER%`, чтобы показать игрокам точно, через сколько времени сервер снова станет доступен. Если ваш таймер указывает, что сервер включится через 45 минут, сообщение отображает этот обратный отсчет в реальном времени. Игроки видят «Сервер включится через 45 минут», и они не будут постоянно обновлять список серверов, задумываясь, что происходит.

Многоязычная поддержка. Если ваш сервер имеет международных игроков, плагин переведен на множество языков. Сообщество поддерживает переводы через Crowdin. Это небольшая деталь, но она показывает, что вы думаете о ваших неанглийских игроках.

Связь прокси через Redis. Управляете несколькими серверами за Velocity или BungeeCord? Синхронизируйте статус обслуживания через соединение Redis. Одна команда переключает режим обслуживания на всех серверах сразу вместо выполнения команды на каждом прокси индивидуально. Экономит время на больших сетях.

Советы и ловушки, которые нужно знать

Самая большая ловушка: режим обслуживания предотвращает входы, но не принудительно отключает уже подключенных игроков. Если кто-то уже на сервере, когда вы включаете обслуживание, они будут продолжать играть. Вам нужно будет вручную выкинуть их или попросить отключиться. Это намеренно - это безопаснее, чем принудительное отключение всех, поскольку это могло бы привести к коррупции данных, если у них были несохраненные изменения.

Некоторые администраторы серверов не осознают, что режим обслуживания поддерживает сервер в работе. Если вы пытаетесь перезапустить весь процесс JVM, Maintenance не поможет - вам все еще нужно выключить и перезапустить сам программное обеспечение сервера. Maintenance предназначен для элегантного онлайн-обслуживания, а не для перезагрузок.

Также, если вы настраиваете другие настройки сервера во время режима обслуживания (например, под調иливаете свойства сервера), помните, что некоторые изменения свойств требуют полного перезапуска для вступления в силу. Режим обслуживания не обходит эти ограничения.

Еще одна вещь: по умолчанию сообщение MOTD нормальное, но оно генеричное. Уделив 10 минут на личностное настройку, чтобы оно соответствовало тону вашего сервера. Сообщение, гласящее «[ОБСЛУЖИВАНИЕ] Custom survival сервер отключен для обновлений» feels way more профессионалнее, чем стандартное сообщение, и ваши игроки оценят личный подход.

Сравнение с другими вариантами

Есть другие решения для обслуживания, но Maintenance выделяется своей гибкостью настройки. Некоторые плагины блокируют вас в жестком формате сообщения. Другие не поддерживают несколько языков или настройки прокси. Maintenance покрывает все эти аспекты без излишеств.

Если вы управляете ванильным сервером и просто хотите самый простой «сервер отключен» текст, вы могли бы технически просто отключить сервер. Но вы теряете возможность разрешить администраторам оставаться подключенными или показать игрокам кастомную причину. Не стоит такого обмена.

Для большинства типов серверов (Paper, Velocity, BungeeCord) Maintenance честно является лучшим бесплатным вариантом. Он легковесен, активно поддерживается и обрабатывает краевые случаи, которые большинство других плагинов игнорируют.