Интеграция с 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 и т. д.).
2. Pano MC Plugin установлен и подключен к вашему экземпляру Pano.
3. В настройках Pano включена Permission Integration.

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

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

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

• Скачать LuckPerms →

Шаг 2: Включение интеграции

1. Войдите в панель администратора Pano.
2. Перейдите в раздел Панель → Настройки сервера → Интеграция с игрой.
3. Включите тумблер Permission Integration.
4. Нажмите Save.

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

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

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

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

IMPORTANT

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

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

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

Из 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 тщательно определяет, какими группами и треками он должен управлять, чтобы избежать случайного удаления данных, созданных вручную.
• Проверка целостности: Pano проверяет хеш каждого узла для обеспечения целостности данных при передаче.

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

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

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

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

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

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

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

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

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