Minecraft-Plugin PermissionsEx

🔌 About PermissionsEx

PermissionsEx (PEX) is a Minecraft plugin that provides full-featured permissions and group management for servers and proxy networks. It exposes a developer API, supports multiple platform implementations, and is designed to be extended with different datastore backends and platform adapters.

🎯 Purpose

PermissionsEx is intended for server administrators and plugin developers who need granular control over permission nodes, group hierarchies, and runtime permission queries. It targets both single-server setups and multi-server/proxy networks by offering platform-specific builds and an implementation-agnostic core.

⚙️ Features

• Fine-grained permission node assignment and group management.
• Programmatic API for plugins to query and modify permissions at runtime.
• Pluggable datastore architecture (supports adding or implementing new backends).
• Multiple platform implementations (Bukkit/Spigot/Paper, Sponge, BungeeCord/Waterfall, Velocity, Fabric).
• Build artifacts available for platform-specific installs and development artifacts for library use.

🧩 Who It Is For

• Server operators who need structured permission groups and inheritance.
• Networks using proxies (BungeeCord/Waterfall, Velocity) that require a consistent permission system across backend servers.
• Plugin developers who need an API to read or modify permission data programmatically.

🏗️ Example Use Cases

• Creating role-based groups (admin, moderator, builder, default) with distinct permission sets.
• A proxy-backed network using platform builds for consistent permission handling across backend servers.
• A developer integrating permission checks into custom plugins via the PEX API.

⚙️ Installation

📥 Setup

• Obtain the official platform build (the project produces .jar artifacts for supported server platforms).
• Place the .jar file into your server's plugins/ directory for Bukkit/Spigot/Paper-like servers (or the appropriate plugin/mod folder for other platforms).
• Restart the server and monitor the server console to confirm the plugin loads and creates its configuration/data directories.

📦 Dependencies

• No runtime dependencies are required by default in the core repository; platform-specific builds are provided. (Do not assume additional plugins are required unless your chosen build or documentation specifies them.)

🧠 Technical Notes

• The project provides a modular core and platform-specific implementations; it is distributed as separate artifacts for different server and proxy platforms.
• An API and Maven/Gradle artifacts are available for developers who want to include PEX components in other projects.
• The source repository has been maintained publicly and includes an issues tracker and documentation resources for setup and development.

🤝 When This Plugin Is Useful

If you need a permissions system that separates core logic from platform implementations and provides an API for developers, PermissionsEx is useful because it offers platform-specific builds, datastore extensibility, and programmatic access to permission data.