Плагін Minecraft PermissionsEx

🔌 Про PermissionsEx

PermissionsEx (PEX) — це плагін Minecraft, що забезпечує повнофункціональне керування дозволами та групами для серверів і мереж проксі. Він надає API для розробників, підтримує реалізації для кількох платформ і спроєктований так, щоб його можна було розширювати різними бекендами сховищ даних та адаптерами платформ.

🎯 Призначення

PermissionsEx призначений для адміністраторів серверів і розробників плагінів, яким потрібен точний контроль над вузлами дозволів, ієрархією груп та запитами дозволів під час виконання. Він підходить як для одного сервера, так і для мереж із кількох серверів/проксі завдяки окремим збіркам для платформ і ядру, незалежному від конкретної реалізації.

⚙️ Можливості

• Точне призначення вузлів дозволів і керування групами.
• Програмний API для плагінів, щоб запитувати й змінювати дозволи під час виконання.
• Плагінна архітектура datastore (підтримує додавання або реалізацію нових бекендів).
• Кілька реалізацій для платформ (Bukkit/Spigot/Paper, Sponge, BungeeCord/Waterfall, Velocity, Fabric).
• Збірки доступні для встановлення під конкретні платформи та артефакти розробки для використання як бібліотеки.

🧩 Для кого це

• Оператори серверів, яким потрібні структуровані групи дозволів та inheritance.
• Мережі, що використовують проксі (BungeeCord/Waterfall, Velocity) і потребують єдиної системи дозволів для backend-серверів.
• Розробники плагінів, яким потрібен API для читання або зміни даних дозволів програмно.

🏗️ Приклади використання

• Створення груп за ролями (admin, moderator, builder, default) з різними наборами дозволів.
• Мережа на основі проксі, яка використовує platform builds для узгодженого керування дозволами на всіх backend-серверах.
• Розробник, який інтегрує перевірки дозволів у власні плагіни через API PEX.

⚙️ Встановлення

📥 Налаштування

• Отримайте офіційну збірку для платформи (проєкт створює .jar артефакти для підтримуваних серверних платформ).
• Помістіть файл .jar у директорію plugins/ вашого сервера для Bukkit/Spigot/Paper-подібних серверів (або у відповідну теку plugin/mod для інших платформ).
• Перезапустіть сервер і стежте за консоллю сервера, щоб переконатися, що плагін завантажився та створив свої каталоги конфігурації/даних.

📦 Залежності

• За замовчуванням у core repository не потрібні runtime-залежності; доступні platform-specific збірки. (Не припускайте, що потрібні додаткові плагіни, якщо це не зазначено у вибраній збірці або документації.)

🧠 Технічні примітки

• Проєкт надає модульне ядро та реалізації для конкретних платформ; він поширюється як окремі артефакти для різних серверних і проксі-платформ.
• Для розробників доступні API та артефакти Maven/Gradle, якщо вони хочуть включити компоненти PEX до інших проєктів.
• Репозиторій з вихідним кодом публічно підтримується та містить tracker проблем і ресурси документації для налаштування й розробки.

🤝 Коли цей плагін корисний

Якщо вам потрібна система дозволів, яка відокремлює основну логіку від реалізацій платформ і надає API для розробників, PermissionsEx корисний, бо пропонує platform-specific збірки, розширюваність datastore і програмний доступ до даних дозволів.