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

LuckPerms — это самый продвинутый, быстрый и безопасный плагин прав доступа для серверов Minecraft. Pano обеспечивает глубокую двустороннюю интеграцию с LuckPerms, позволяя вам управлять всей структурой прав доступа вашего сервера напрямую из веб-панели.

В отличие от традиционных решений, где веб-панели только просматривают данные, Pano выступает в качестве централизованного узла управления для LuckPerms.

Что такое интеграция с LuckPerms?

Интеграция Pano с LuckPerms синхронизирует группы, треки (трассы) и узлы прав (permission nodes) в режиме реального времени. Изменения, внесенные в панели Pano, мгновенно отражаются в игре, а изменения, внесенные в игре (через команды LuckPerms или другие плагины), автоматически передаются в Pano.

Особенности

• Полная двусторонняя синхронизация — синхронизация между игрой и вебом в реальном времени.
• Управление группами — создание, редактирование и удаление групп прямо из панели.
• Поддержка треков (Tracks) — удобное управление путями повышения и понижения в звании.
• Редактор узлов прав — добавление или удаление прав доступа для групп и пользователей.
• Поддержка метаданных — полная поддержка префиксов, суффиксов, отображаемых имен и весов (weights).
• Поддержка контекстов — работа с контекстами LuckPerms (сервер, мир и т. д.).
• Временные права — управление правами доступа, которые истекают автоматически.
• Управляемые состояния — Pano использует специальные маркеры (pano-managed), чтобы безопасно управлять сущностями, не конфликтуя с ручными изменениями в игре.

Требования

1. LuckPerms (v5.0+) установлен на вашем сервере Minecraft (Spigot, Paper, Folia, BungeeCord, Velocity или Fabric).
2. Pano MC Plugin установлен и подключен к вашему экземпляру Pano.
3. Для этого сервера включена Интеграция разрешений (по умолчанию включена).

Руководство по настройке

Шаг 1: Установка LuckPerms

Убедитесь, что LuckPerms установлен и работает на вашем сервере Minecraft.

• Скачать LuckPerms →

Шаг 2: Проверка интеграции

1. Войдите в панель администратора Pano.
2. Выберите сервер и откройте его вкладку Настройки → Интеграция с игрой (настройки задаются для каждого сервера).
3. Убедитесь, что тумблер Интеграция разрешений включён — по умолчанию он включён.
4. Если вы его меняли, сохраните настройки.

Шаг 3: Ожидание синхронизации

После включения Pano MC Plugin автоматически обнаружит LuckPerms:

• Он подключится к шине событий (Event Bus) LuckPerms для отслеживания изменений.
• Затем он применит данные о правах из Pano к LuckPerms; последующие изменения в LuckPerms отправляются в Pano.

Эксклюзивные права Pano

IMPORTANT

Когда вы добавляете узел прав через панель Pano, он автоматически включает контекст pano: true. Это указывает на то, что данное право относится только к платформе Pano. Оно сохраняется в LuckPerms с контекстом pano=true, который в игре никогда не действует, поэтому право не влияет на игру.

Эта функция позволяет управлять веб-правами (например, уровнями доступа к панели или функциями сайта), избегая конфликтов в игре.

Как работает синхронизация

Из Pano в игру (Inbound)

Когда вы сохраняете изменения в разделе Права доступа панели Pano:

1. Pano отправляет снимок обновлений (snapshot) в Pano MC Plugin.
2. Плагин мгновенно применяет эти изменения в LuckPerms.
3. Группы, треки и узлы прав обновляются.

Из игры в Pano (Outbound)

Когда изменение прав происходит в игре (например, через команду /lp user ... permission set ...):

1. LuckPerms генерирует событие.
2. Pano MC Plugin перехватывает это событие и ждет короткий период (debounce), чтобы обработать пакетные изменения.
3. Плагин отправляет свежий снимок текущего состояния прав в Pano.

Безопасность и разрешение конфликтов

Pano разработан для сосуществования с ручным использованием LuckPerms:

• Управляемые маркеры: Pano добавляет узел meta.pano-managed.true к сущностям, которыми он управляет.
• Защита от удаления: При синхронизации Pano тщательно определяет, какими группами и треками он должен управлять, чтобы избежать случайного удаления данных, созданных вручную.

Устранение неполадок

Интеграция не загружается

• Проверьте, установлен ли LuckPerms (команда /plugins в игре).
• Найдите строку [Pano] Permission integration is enabled, loading... в консоли сервера.
• Убедитесь, что тумблер Интеграция разрешений включен в панели.

Задержка синхронизации

• Pano использует короткий период ожидания (около 1,5 сек) для исходящей синхронизации, чтобы предотвратить перегрузку сети при массовых операциях.
• Если изменения не появляются, проверьте, подключен ли Pano MC Plugin (страница Обзор сервера или /pano status в игре).

Нужна помощь?

Если у вас возникли проблемы или есть предложения:

• Посетите наше сообщество Discord.
• Создайте тикет на GitHub.

Интеграция с LuckPerms делает управление сложными правами доступа сервера таким же простым, как нажатие кнопки.