Advanced Whitelist

Advanced Whitelist предоставляет продвинутые инструменты управления доступом, включая систему интерактивных запросов и полноценную интеграцию с Discord.

Advanced Whitelist расширяет стандартные возможности белого списка, делая процесс управления доступом на сервер более интерактивным. Основное отличие проекта заключается в системе динамических запросов: игроки могут отправлять заявки на вход в реальном времени, а администраторы получают возможность мгновенно их обрабатывать.

Система запросов

Когда игрок пытается подключиться к серверу, он отправляет запрос администратору. Если администратор находится в сети, запрос отображается в чате как интерактивное сообщение, которое можно принять мгновенно. В случае отсутствия администратора, запрос сохраняется на заданное время и может быть обработан позже через команду /whitelist requests. В заявках игроки могут указывать причину присоединения, которая отображается в обзоре запросов и в интерактивных сообщениях.

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

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

• Слеш-команды для управления списком, включения/выключения белого списка и просмотра запросов.
• Модальное окно /request для подачи заявок с указанием причины.
• Настройка ролей для доступа к командам бота и использованию формы запроса.
• Логирование протокола действий с белым списком в выделенный канал Discord.

Команды плагина

Для управления белым списком внутри игры используйте следующие команды:

/whitelist <add/remove> <player>
/whitelist list
/whitelist toggle/on/off
/whitelist set
/whitelist requests
/whitelist reload

Права доступа

Для корректной работы плагина необходимо настроить соответствующие права доступа (permissions):

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

Основные параметры плагина можно изменить в файле конфигурации. Доступные настройки включают выбор языка (English, German) и время жизни запроса (RequestsExpiration).

Настройка Discord бота

Для активации интеграции необходимо создать приложение в Discord Developer Portal, создать бота и включить Privileged Gateway Intents (Presence, Server Members, Message Content). После получения токена его следует вставить в конфиг.

Discord-Bot:
  Enabled: true
  Token: "YOUR_BOT_TOKEN_HERE"
  Permissions:
    UseAdmin: true
    UseRoleId: 0
  Protocol:
    ChannelId: 0
  Model:
    Request:
      MinChars: 30
      MaxChars: 200
      RequiredRole: false
      RoleId: 0

Команды Discord

В среде Discord доступны следующие слеш-команды:

• /whitelist toggle — Переключение белого списка
• /whitelist add — Добавление игрока
• /whitelist remove — Удаление игрока
• /whitelist list — Список участников
• /whitelist requests — Ожидающие запросы
• /whitelist info — Детали конкретного запроса
• /request — Открытие модального окна заявки