Plugin Minecraft PermissionsEx

🔌 Despre PermissionsEx

PermissionsEx (PEX) este un plugin Minecraft care oferă gestionare completă a permisiunilor și grupurilor pentru servere și rețele proxy. Expune un API pentru dezvoltatori, suportă implementări pentru mai multe platforme și este conceput pentru a fi extins cu diferite backend-uri datastore și adaptoare de platformă.

🎯 Scop

PermissionsEx este destinat administratorilor de servere și dezvoltatorilor de pluginuri care au nevoie de control detaliat asupra permission nodes, ierarhiilor de grup și interogărilor de permisiuni la runtime. Țintește atât configurații cu un singur server, cât și rețele multi-server/proxy, oferind build-uri specifice platformei și un nucleu independent de implementare.

⚙️ Caracteristici

• Atribuire granulară a permission nodes și gestionare de grupuri.
• API programatic pentru pluginuri, pentru a interoga și modifica permisiunile la runtime.
• Arhitectură datastore extensibilă (suportă adăugarea sau implementarea de backend-uri noi).
• Mai multe implementări pentru platforme (Bukkit/Spigot/Paper, Sponge, BungeeCord/Waterfall, Velocity, Fabric).
• Artefacte de build disponibile pentru instalări specifice platformei și artefacte de dezvoltare pentru utilizare ca bibliotecă.

🧩 Pentru cine este

• Operatorii de servere care au nevoie de grupuri de permisiuni structurate și inheritance.
• Rețelele care folosesc proxy-uri (BungeeCord/Waterfall, Velocity) și au nevoie de un sistem de permisiuni consecvent între serverele backend.
• Dezvoltatorii de pluginuri care au nevoie de un API pentru a citi sau modifica programatic datele de permisiuni.

🏗️ Exemple de utilizare

• Crearea de grupuri bazate pe roluri (admin, moderator, builder, default) cu seturi diferite de permisiuni.
• O rețea bazată pe proxy care folosește build-uri ale platformei pentru gestionarea consecventă a permisiunilor pe serverele backend.
• Un dezvoltator care integrează verificările de permisiuni în pluginuri personalizate prin API-ul PEX.

⚙️ Instalare

📥 Configurare

• Obțineți build-ul oficial pentru platformă (proiectul produce artefacte .jar pentru platformele de server suportate).
• Plasați fișierul .jar în directorul plugins/ al serverului dvs. pentru servere de tip Bukkit/Spigot/Paper (sau în folderul plugin/mod potrivit pentru alte platforme).
• Reporniți serverul și urmăriți consola serverului pentru a confirma că pluginul se încarcă și își creează directoarele de configurare/date.

📦 Dependențe

• În mod implicit, core repository nu necesită dependențe runtime; sunt furnizate build-uri specifice platformei. (Nu presupuneți că sunt necesare pluginuri suplimentare decât dacă build-ul sau documentația aleasă specifică acest lucru.)

🧠 Note tehnice

• Proiectul oferă un nucleu modular și implementări specifice platformelor; este distribuit ca artefacte separate pentru diferite platforme de server și proxy.
• Un API și artefacte Maven/Gradle sunt disponibile pentru dezvoltatorii care doresc să includă componente PEX în alte proiecte.
• Repository-ul sursă este întreținut public și include un tracker de issue-uri și resurse de documentație pentru configurare și dezvoltare.

🤝 Când este util acest plugin

Dacă aveți nevoie de un sistem de permisiuni care separă logica de bază de implementările platformei și oferă un API pentru dezvoltatori, PermissionsEx este util deoarece oferă build-uri specifice platformei, extensibilitate datastore și acces programatic la datele de permisiuni.