Staff+

Staff+ — плагин для модерации серверов Minecraft

Staff+ — это высокопроизводительный плагин для модерации и утилит, разработанный для современных сетей Minecraft. Проект поставляется в виде двух специализированных JAR-файлов: для серверов на базе Paper/Purpur/Folia и для прокси Velocity. Обе версии используют единый ядро для обеспечения согласованного управления наказаниями в масштабе всей сети. Серверная версия обеспечивает безопасность в многопоточной среде Folia, а версия для прокси перехватывает наказания на уровне шлюза до подключения игроков к бэкенд-серверам.

🛡️ Архитектура и платформы

Staff+ — это корпоративный инструмент модерации и утилиты, разработанный специально для современных сетей Minecraft. Проект поставляется в виде двух независимых платформоспецифичных JAR-файлов, объединенных единым ядром для обеспечения согласованного управления наказаниями во всей сети. Первая сборка (Paper Edition) предназначена для бэкенд-серверов Paper, Purpur и Folia, обеспечивая полную безопасность в многопоточной среде Folia. Вторая сборка (Velocity Edition) работает на прокси Velocity 3.3.0+, перехватывая наказания на уровне шлюза до того, как игрок достигнет любого сервера в бэкенде. Обе версии используют общую базу данных и конфигурацию, что позволяет хранить историю наказаний в одном месте и применять их сетевым образом.

📊 Сравнение функционала платформ

⚙️ Кроссплатформенное ядро и миграция

Сердцем плагина является модуль staff-core, который содержит базу данных, модель наказаний и движок миграции. Обе платформы читают и записывают данные в одну и ту же базу (SQLite или MySQL), обеспечивая бесшовную модерацию. Движок миграции позволяет импортировать наказания из более чем 7 популярных плагинов, включая EssentialsX, LiteBans, AdvancedBan, MaxBans и BanManager. Система поддерживает автоматическое сканирование файлов сервера, извлечение путей к базам данных и выполнение пакетных операций для мгновенной миграции тысяч записей в рамках одной транзакции.

👻 Система Vanish (Только Paper)

На серверах Paper реализована полная система невидимости. Игрок полностью исчезает из списка онлайн, пингов, автодополнения команд и видимых списков. Персонаж администратора игнорирует физические триггеры (платформы, ловушки) и не вызывает мобов. Система поддерживает «тихие» контейнеры: открытие сундуков, печей и бочек происходит без анимаций и звуков. Также реализована защита от подбора предметов и подавление сообщений о входе/выходе. Статус отображается в реальном времени через индикатор в интерфейсе действия (Action Bar). Для отключения невидимости другим игрокам требуется право staff.vanish.see.

👁️ Инспекция инвентаря и мониторинг (Только Paper)

Инспектор инвентаря (/invsee) открывает 54-слотный GUI, позволяющий администраторам просматривать и редактировать инвентарь цели в реальном времени. Интерфейс показывает слоты брони, предметы в руках, зелья и статистику. Для мониторинга игроков доступен режим зрительского слежения (/monitor), который использует векторы скорости цели для предсказания её движения и позиционирования камеры чуть впереди, исключая подергивания. Обновления выполняются с интервалом в 4 такта (200 мс) с кулдауном 400 мс, что обеспечивает плавность и безопасность в среде Folia.

📜 Список сетевых команд (Paper & Velocity)

Эти команды работают на обеих платформах и используются для управления сетевым баном и модерации:

🎮 Команды только для Paper (Сервер)

Эти команды доступны исключительно на серверах Paper/Purpur/Folia для расширенного управления игрой:

⚠️ Важные оговорки по безопасности

Плагин реализует защиту от иерархии: администраторы с низким рангом не могут отменять или изменять наказания, выданные администраторами с высоким рангом или консолью (конфигурируется через staff.hierarchy.weight). Также доступна функция staffallow, позволяющая временно разрешить конкретному игроку зайти на сервер, даже если его IP-адрес забанен, без снятия самого IP-бана для остальных пользователей.

🛠️ Настройка конфигурации и базы данных

Плагин использует фреймворк Okaeri Config для генерации и валидации файлов. Форматы config.yml и messages.yml идентичны на обеих платформах. В config.yml можно настроить тип хранилища (SQLite или MySQL), параметры подключения к базе данных, эскалацию предупреждений (например, 1 предупреждение = 1 час мута, 3 = временный бан) и логирование в Discord Webhook. Сообщения поддерживают Adventure MiniMessage для использования цветов и градиентов. Для совместной работы сетей обе версии должны указывать на одну и ту же MySQL-базу данных.

🔧 Пример конфигурации MySQL (для сети)

Чтобы синхронизировать наказания между серверами и прокси, настройте оба файла `config.yml` следующим образом:

📈 Интеграция с Discord и метрики

Для логирования действий модерации используется Discord Webhook, который отправляет неблокирующие эмбеды в реальном времени с настройкой цветов для разных событий (бан — красный, мут — оранжевый, предупреждение — желтый). Плагин интегрируется с bStats для сбора анонимной статистики: на серверах Paper используется bstats-bukkit, а на прокси Velocity — bstats-velocity (Plugin ID: 31693). Отслеживание можно отключить через файл конфигурации bStats.

🏗️ Архитектура и требования для разработчиков

Staff+ — это многомодульный Gradle-проект, написанный на Java 21. Архитектура включает общее ядро staff-core, модуль staff-paper для серверов и модуль staff-velocity для прокси. Gradle автоматически перемещает библиотеки eu.okaeri, com.zaxxer.hikari и другие в приватные пространства имен, предотвращая конфликты. Для сборки используется команда ./gradlew clean build. Артефакты находятся в staff-paper/build/libs/ и staff-velocity/build/libs/. CI/CD-пайплайн через GitHub Actions автоматически компилирует и распространяет артефакты.

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