ServerChangelogs

Плагин ServerChangelogs для Minecraft 1.21.11

ServerChangelogs — серверный плагин для платформ Paper, Purpur и Velocity, который позволяет администраторам показывать игрокам логи изменений (changelogs) в виде удобных диалоговых окон. В отличие от текстовых сообщений в чате или книг, диалоги невозможно пропустить и их легко читать. Плагин автоматически отслеживает, какие логи уже прочитал игрок, и помечает новые сообщения индикаторами. Для создания и редактирования логов используется встроенный редактор с сохранением сессий, а форматирование текста поддерживается через MiniMessage.

Основной принцип работы

Плагин ServerChangelogs решает проблему информирования игроков о важных обновлениях сервера, используя нативные диалоговые интерфейсы (Dialog UIs) Minecraft. В отличие от текстовых сообщений в чате или книг, которые можно пропустить или игнорировать, диалоговое окно блокирует доступ к игровому миру до тех пор, пока игрок не ознакомится с содержанием. Это гарантирует, что игрок не пропустит критически важную информацию. Плагин автоматически определяет, какие логи изменений (changelogs) еще не были прочитаны игроком, и открывает соответствующее окно при его подключении к серверу.

Интерфейс отображения и навигация

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

Инструменты создания и редактирования

Для администраторов сервера предусмотрен удобный диалоговый редактор, доступный через команду /scl create. Интерфейс позволяет создавать новые логи изменений с использованием богатого форматирования текста, поддерживаемого системой MiniMessage (цвета, жирный шрифт, ссылки). Редактор обладает функцией сохранения сессий: администратор может выйти из игры или закрыть окно редактирования, не теряя внесенных изменений, и вернуться к работе позже. Это особенно полезно при составлении длинных описаний обновлений, требующих времени на обдумывание.

Система команд и управление правами

Плагин предоставляет гибкую систему команд для администраторов и игроков, доступ к которым регулируется через права доступа. Основные команды включают:

• /scl info — выводит информацию о версии плагина и текущей платформе;
• /scl reload — перезагружает конфигурацию и языковые файлы без остановки сервера;
• /changelog — удобная команда для игроков для просмотра логов (является алиасом для /scl view).

Администраторы, имеющие право server_changelogs.manage, могут редактировать или удалять существующие логи прямо из интерфейса просмотра, используя специальные кнопки управления.

Настройка конфигурации и локализация

Конфигурация плагина хранится в файле config.yml, где можно настроить параметры хранения данных, форматирование и макет интерфейса. Основное кастомизирование осуществляется через языковые файлы в директории lang, использующие формат MiniMessage. Плагин поддерживает пользовательские теги для автоматической подстановки данных, таких как префикс плагина, его описание, список авторов и версия платформы. По умолчанию доступны файлы на американском английском (en_US), но администраторы могут легко добавить поддержку других языков, создав файлы с соответствующими кодами регионов (например, ru_RU, de_DE).

Планируемые улучшения

Разработчик активно работает над расширением функционала плагина. В ближайших планах — внедрение поддержки реляционных баз данных (JDBC) для хранения данных о прочитанных логах, что значительно улучшит производительность при большом количестве обновлений по сравнению с текущим использованием YAML-файлов. Также планируется добавить возможность выбора из списка предустановленных авторов, настройку отображения только последних обновлений при входе и систему пагинации для длинной истории изменений. В отдаленной перспективе рассматривается внедрение системы голосования по изменениям и поддержка других типов интерфейсов, таких как чат или книги.

Сценарии использования

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

Автор: codingcat · Лицензия: MIT