monban (Whitelist)

monban предоставляет продвинутый контроль доступа для автономных серверов и сетей Velocity, обеспечивая поддержку различных типов личностей игроков и синхронизацию прав.

monban представляет собой комплексную систему контроля доступа (whitelist), управления правами и идентификации игроков. Плагин поддерживает три типа личностей: ONLINE, OFFLINE и FLOODGATE, что позволяет четко определять доверие к пользователю независимо от наличия UUID.

Плагин предлагает гибкие инструменты для организации прав доступа как на отдельных серверах, так и в масштабируемых сетях Velocity.

• Поддержка групп игроков, независимых от определений SERVER_GROUP в Velocity.
• Назначение прав доступа группам или конкретным игрокам для прокси и бэкенд-плагинов.
• Три уровня области доступа: NETWORK, SERVER_GROUP и SERVER.
• Групповой доступ к отдельным бэкенд-серверам или группам серверов.
• Автоматический поиск профиля ONLINE по имени игрока с возможностью ручного ввода UUID.
• Интерактивные списки белого списка и ограниченного доступа с поддержкой пагинации и фильтрации.
• Синхронизация состояния сети Velocity с бэкендами Bukkit и Paper.
• Локальные права доступа на бэкендах без необходимости использования LuckPerms.
• Поддержка Native Folia-совместимого планирования на платформе Paper.

В сетевом режиме Velocity выступает центральным органом управления. Для работы синхронизированных прав необходимо включить backend-permissions в конфигурации Velocity.

backend-permissions:
  enabled: true

После запуска Velocity автоматически создаст файл plugins/monban/sync.yml. Его содержимое необходимо скопировать на каждый включенный бэкенд. В конфигурации бэкенда укажите server-name, соответствующий зарегистрированному имени в Velocity.

backend-permissions:
  enabled: true
  server-name: lobby

Пример настройки доступа для группы модераторов к командам плагина Chunky:

/monban group create moderator
/monban group moderator access grant server lobby
/monban group moderator permission add server lobby chunky.command.start
/monban group moderator permission add server lobby chunky.command.cancel
/monban user hanamuramiyu offline group add moderator

Поддержка Bedrock-игроков доступна на платформе Velocity. monban распознает такие подключения как личности типа FLOODGATE.

Интеграция с Floodgate отключена по умолчанию. Рекомендуется включить require-provider: true, чтобы плагин выдавал ошибку при запуске, если провайдер отсутствует.

identity:
  mode: AUTO
  floodgate:
    enabled: true
    require-provider: true

Для добавления игрока Bedrock используйте нормализованное имя (обычно имя, видимое на сервере):

/monban whitelist add floodgate .BedrockName

Администрирование белого списка унифицировано для всех платформ через стандартную модель управления.

• Команды для автономных серверов:
• /monban whitelist enable — включить управление списком
• /monban whitelist disable — отключить управление списком
• /monban whitelist add online — добавить игрока с автоматическим разрешением профиля
• Команды для Velocity:
• /monban access ... — управление доступом
• /monban lookup — детали личности и статус в белом списке
• /monban status — сводка текущего доступа в реальном времени

Плагин использует строгую версионную конфигурацию YAML и обеспечивает отказоустойчивость: в случае критических ошибок проверки доступа при запуске система переходит в режим fail-closed (закрытый доступ).

Для автономных серверов необходимо отключить стандартный белый список в server.properties, установив white-list=false.

Технические требования к среде выполнения: плагин monban требует Java 21. Обратите внимание, что для работы на платформе Paper версии 26.1+ требуется Java 25.