Minecraft plugin PermissionsEx

🔌 O PermissionsEx

PermissionsEx (PEX) je Minecraft plugin, který poskytuje plně vybavenou správu oprávnění a skupin pro servery a proxy sítě. Nabízí vývojářské API, podporuje více implementací pro různé platformy a je navržen tak, aby šel rozšiřovat pomocí různých datastore backendů a platformních adaptérů.

🎯 Účel

PermissionsEx je určen pro správce serverů a vývojáře pluginů, kteří potřebují podrobnou kontrolu nad permission nody, hierarchií skupin a dotazy na oprávnění za běhu. Cílí jak na jedno-serverové instalace, tak na multi-server/proxy sítě tím, že nabízí buildy pro konkrétní platformy a jádro nezávislé na implementaci.

⚙️ Funkce

• Jemně členěné přiřazování permission nodů a správa skupin.
• Programové API pro pluginy pro dotazování a úpravu oprávnění za běhu.
• Připojitelná architektura datastore (podporuje přidání nebo implementaci nových backendů).
• Více implementací pro platformy (Bukkit/Spigot/Paper, Sponge, BungeeCord/Waterfall, Velocity, Fabric).
• Build artefakty dostupné pro instalace specifické pro platformu a vývojové artefakty pro použití jako knihovna.

🧩 Pro koho to je

• Provozovatelé serverů, kteří potřebují strukturované skupiny oprávnění a dědičnost.
• Sítě používající proxy (BungeeCord/Waterfall, Velocity), které potřebují konzistentní systém oprávnění napříč backend servery.
• Vývojáři pluginů, kteří potřebují API pro programové čtení nebo úpravu dat oprávnění.

🏗️ Příklady použití

• Vytváření skupin podle rolí (admin, moderator, builder, default) s odlišnými sadami oprávnění.
• Proxy-backed síť využívající platformní buildy pro konzistentní zpracování oprávnění napříč backend servery.
• Vývojář integrující kontrolu oprávnění do vlastních pluginů přes PEX API.

⚙️ Instalace

📥 Nastavení

• Získejte oficiální build pro platformu (projekt vytváří .jar artefakty pro podporované serverové platformy).
• Umístěte soubor .jar do adresáře plugins/ na vašem serveru pro servery typu Bukkit/Spigot/Paper (nebo do odpovídající složky plugin/mod pro jiné platformy).
• Restartujte server a sledujte serverovou konzoli, abyste potvrdili, že se plugin načetl a vytvořil své konfigurační/datové adresáře.

📦 Závislosti

• Ve výchozím stavu nejsou v core repository vyžadovány žádné runtime závislosti; jsou poskytovány platformně specifické buildy. (Nepředpokládejte, že jsou potřeba další pluginy, pokud to váš zvolený build nebo dokumentace výslovně neuvádí.)

🧠 Technické poznámky

• Projekt poskytuje modulární jádro a implementace pro konkrétní platformy; je distribuován jako samostatné artefakty pro různé serverové a proxy platformy.
• API a artefakty Maven/Gradle jsou k dispozici pro vývojáře, kteří chtějí zahrnout komponenty PEX do jiných projektů.
• Zdrojový repozitář je veřejně udržován a obsahuje tracker problémů i dokumentační zdroje pro nastavení a vývoj.

🤝 Kdy je tento plugin užitečný

Pokud potřebujete systém oprávnění, který odděluje jádrovou logiku od implementací platforem a poskytuje API pro vývojáře, je PermissionsEx užitečný, protože nabízí platformně specifické buildy, rozšiřitelnost datastore a programový přístup k datům oprávnění.