Minecraft plugin LuckPerms

🔌 About LuckPerms

LuckPerms — is a plugin for Minecraft servers that provides a robust, high‑performance permissions management system. LuckPerms lets server administrators create groups, assign granular permission nodes, and manage user/group data at scale. The plugin is designed for modern server platforms (Bukkit/Spigot/Paper and many proxies/loaders) and includes a web editor for visual editing.

🎯 Purpose

LuckPerms addresses the complexity of managing permissions on medium→large Minecraft networks. By centralizing permission data, offering scalable storage backends and a web editor, LuckPerms reduces manual console work and configuration drift across servers.

The plugin is used to:

• Define groups and inheritance hierarchies.
• Assign fine‑grained permission nodes to users and groups.
• Persist permissions in scalable storage backends and sync across servers.

⚙ Main features

• High‑performance, scalable permissions engine.
• Web editor for visual management (command: /lp editor). ()
• Cross‑platform support (Bukkit/Spigot/Paper, proxies and multiple loaders). ()
• Flexible storage options (supports a variety of backends; see official docs for supported databases). ()
• API for other plugins and integrations (official API & provider). ()

🧩 Who it fits

LuckPerms is suitable for:

• Survival and large public servers that require granular permission control.
• Proxy networks that need a centralized permission source.
• Server administrators who want a web GUI for editing groups and permissions.

Not strictly necessary for tiny local/test servers where simple operator checks suffice.

🏗 Examples of usage

• Use LuckPerms to create role hierarchies (default → moderator → admin) and assign plugin permission nodes to groups.
• Open the web editor via /lp editor to visually edit groups and then trust the session from console with /lp trusteditor <code> if required. ()
• Store permissions in an external DB to share data between backend servers on a proxy network. ()

⚡ Highlights

• Open‑source, actively maintained project (source & releases on GitHub and luckperms.net). ()
• Designed for performance and scale used by large server networks. ()

⌨️ Commands

Note: LuckPerms exposes many subcommands (user/group/track/editor/verbose/etc.). A complete, authoritative command list is maintained in the official documentation. ()

🔐 Permissions

The plugin provides a wide set of permission nodes. Do not rely on a single wildcard; consult the official docs for per‑command/per‑feature nodes. ()

⚙ Installation

📥 Installation

• Download the LuckPerms JAR for your platform (Bukkit/Spigot/Paper, proxy or loader) from the official downloads. ()
• Place the JAR in your server's plugins/ folder.
• Fully restart the server (do not use /reload).
• Check the console to confirm LuckPerms loaded successfully (you can run lp in the console to verify). ()

📦 Dependencies

• LuckPerms is distributed as a self‑contained plugin across supported platforms. No mandatory external plugin dependencies are required to run the core functionality. For optional integrations and specifics, consult the official docs. ()

🧾 Configuration

• LuckPerms generates its configuration and data folder on first run (plugins/LuckPerms/ and config files). Example config.yml and data adapters are provided. ()
• Configuration generally does not require edits for basic usage, but setting storage backend and server name is common when running networks.
• The plugin supports multiple storage adapters — see official documentation for supported backends and setup steps. ()

🧠 Additional information

⚠ Known conflicts

• Conflicts are uncommon but may occur if multiple plugins attempt to provide identical permission management functionality. Test on a staging server when combining with other permission systems.

🚧 Limitations

• Full feature set and precise behavior depend on the platform build (Bukkit/Spigot/Paper vs Fabric/Forge/NeoForge/Velocity). Verify you download the correct build for your server type. ()

❓ FAQ

1. How do I open the web editor? Run /lp editor in‑game or in the server console; LuckPerms will generate a URL and a trust code if required. ()

2. Does LuckPerms support proxies (Bungee/Velocity)? Yes — LuckPerms provides builds and guidance for proxy environments; follow the platform‑specific docs. ()

3. Is there a GUI for editing permissions? Yes — the web editor provides a visual interface (access via /lp editor). ()

4. Where do I report bugs or request features? Use the project's GitHub issues on the LuckPerms repository. ()

Telemetry / bStats

• Information about telemetry or bStats usage is not explicitly included in the sources fetched here. Check the official docs or config files for an opt‑out option. ()

Support & Community

• Official website and web apps: luckperms.net. ()
• Source code & issue tracker: GitHub (LuckPerms/LuckPerms). ()
• Official Discord community is available for real‑time support. ()

🤝 When to use LuckPerms

If you run a Paper/Spigot server or a multi‑server network that needs reliable, auditable and scalable permission management, LuckPerms is a proven solution with a web editor and active development. Source and docs are hosted on GitHub and luckperms.net — consult them for platform‑specific installation steps and the full command/permission references. ()