AdminNotes — незаменимый помощник администратора Minecraft-сервера
Управление сервером Minecraft требует не только технических знаний, но и хорошей памяти. Когда на проекте играют десятки или сотни человек, уследить за каждым нарушителем, запомнить причины предупреждений или особенности поведения игроков становится практически невозможно. Плагин AdminNotes решает эту проблему, позволяя вести подробные заметки прямо на сервере. Это легковесный, но мощный инструмент, который превращает хаос в порядок и помогает администрации работать слаженно.
Основные возможности AdminNotes
Плагин создан для того, чтобы администраторы могли фиксировать важную информацию о любом игроке. Вот что он умеет:
- Создание текстовых заметок, привязанных к конкретному игроку.
- Удобный просмотр всех заметок с разбивкой по страницам.
- Поиск по имени игрока, автору заметки или ключевому слову.
- Уведомления при входе игрока, если на него установлен флаг оповещения.
- Автоматическая генерация заметок при использовании определённых команд — мут, кик, бан и других.
- Поддержка SQLite и MySQL для хранения данных.
- Гибкая система прав, позволяющая разграничить доступ персонала.
- Интеграция с системой метрик mcstats.org для сбора анонимной статистики.
Установка и первые шаги
Для начала работы с AdminNotes достаточно поместить JAR-файл в папку plugins вашего сервера и перезапустить его. Плагин автоматически создаст конфигурационные файлы и базу данных. Кстати, если вы пользуетесь лаунчером foxygame.net, то установить этот мод можно буквально в пару кликов прямо из меню — удобный, гибкий и современный лаунчер для Minecraft, где можно скачать моды прямо из меню. После запуска сервера необходимо выдать соответствующие права через любой пермишен-плагин — LuckPerms, PermissionsEx или аналогичный. Базовая настройка сводится к редактированию config.yml, где можно указать тип базы данных, префикс чата и другие параметры.
Команды для работы с заметками
Все действия выполняются через корневую команду /notes. Вот список основных подкоманд:
- /notes create — создать новую заметку на игрока.
- /notes list — вывести список заметок с учётом количества на странице.
- /notes info — показать автора, дату создания и статус уведомления для конкретной заметки.
- /notes notify — переключить флаг оповещения: при следующем входе игрока администраторы получат сообщение.
- /notes search — поиск заметок по фильтрам: p:никнейм (игрок), w:никнейм (автор), k:ключевое слово.
- /notes remove — удалить выбранную заметку.
Эти команды покрывают все повседневные сценарии — от быстрой фиксации нарушения до детального анализа истории игрока.
Система прав и разрешений
Гибкая система пермишенов позволяет точно настроить, кто из персонала что может делать. Основные узлы:
- adminnotes.mod — базовый доступ, включает просмотр списка и получение уведомлений о создании заметок.
- adminnotes.create — возможность создавать заметки.
- adminnotes.list — просмотр всех заметок.
- adminnotes.info — просмотр детальной информации о заметке.
- adminnotes.notify — переключение флага уведомления.
- adminnotes.remove — удаление заметок.
- adminnotes.admin — полный доступ ко всем функциям плагина.
- adminnotes.autonote.* — разрешение на все автоматические заметки, описанные в auto-notes.yml.
- adminnotes.login-notified — получение уведомления при входе игрока с активным флагом.
- adminnotes.create-notified — оповещение при создании новой заметки другим администратором.
Такая детализация позволяет избежать путаницы: модератор может оставлять заметки, но не удалять их, а старший администратор — управлять всеми записями.
Гибкая конфигурация
Файл config.yml содержит множество полезных настроек. Вот ключевые из них:
- chat-prefix — префикс, отображаемый перед сообщениями плагина в чате.
- db-type — выбор между SQLite и MySQL. Для крупных проектов рекомендуется MySQL.
- permission-default — поведение прав по умолчанию: op/not op/true/false.
- notify-by-default — если true, все новые заметки по умолчанию будут уведомлять при входе игрока.
- notes-per-page — количество заметок на одной странице при использовании /notes list.
- date-format — формат даты в заметках.
- check-new-version — проверка обновлений при запуске сервера.
- async-db-queries — асинхронные запросы к базе данных для снижения лагов.
- confirm-player-joined — требовать подтверждения, что игрок когда-либо заходил на сервер, чтобы избежать опечаток в нике.
- auto-note-permission — требовать отдельное право для создания авто-заметок.
- use-metrics — отправка анонимной статистики на mcstats.org.
Отдельного внимания заслуживает секция mysql, где прописываются хост, порт, имя базы данных и учётные данные — всё стандартно для любого Bukkit-плагина.
Автоматические заметки: мощный инструмент контроля
Файл auto-notes.yml позволяет настроить создание заметок при выполнении определённых команд. Это незаменимо для ведения автоматического журнала наказаний. Каждое правило содержит:
- title — уникальное название авто-заметки.
- commands — список команд, за которыми нужно следить.
- regex — регулярное выражение для извлечения данных из текста команды.
- note — шаблон заметки, где $1, $2 и т.д. заменяются на найденные группы, <commander> — на ник администратора, <location> — на его координаты.
- player — номер группы в regex, которая соответствует нику игрока, на которого создаётся заметка.
- notify — принудительно включить или выключить флаг уведомления для этой авто-заметки.
Например, можно автоматически записывать причину мута, длительность и кто его выдал, что экономит время и исключает человеческий фактор.
Метрики и конфиденциальность
AdminNotes использует систему метрик Hidendra, которая собирает обезличенную информацию: уникальный идентификатор сервера, версию Java, режим онлайн/офлайн, версию плагина, ОС, количество ядер процессора и игроков онлайн. Эти данные отправляются на mcstats.org и помогают разработчику оценить популярность плагина. Если вы не хотите участвовать в сборе статистики, достаточно выставить параметр use-metrics в false в конфигурации. Исходный код плагина открыт, а поддержать проект можно через Bitcoin-донат.
Заключение
AdminNotes — это простой, но крайне эффективный способ навести порядок в администрировании Minecraft-сервера. Возможность вести заметки, получать уведомления при входе проблемных игроков и автоматически фиксировать наказания превращает хаотичное управление в прозрачный процесс. Плагин легко настраивается, нетребователен к ресурсам и отлично вписывается в любой проект — от небольшого ванильного сервера до крупной сети с модами. Попробуйте AdminNotes, и вы заметите, насколько проще станет работа вашей команды.