MINECRAFTHUB.IO
Plugins

LuckPerms

A fast, flexible permissions plugin for Bukkit, Spigot, Paper, BungeeCord, Velocity, and Waterfall servers, with a web editor and a wide range of storage backends.

By lucko via Modrinth.

LuckPerms banner with the project name and key in the project's lime accent color
Section
Server Plugin
Platform
Java
Versions
v 1.8.8 / 1.8.9 / 1.9 / 1.9.1 / 1.9.2 / 1.9.3 / 1.9.4 / 1.10 / 1.10.1 / 1.10.2 / 1.11 / 1.11.1 / 1.11.2 / 1.12 / 1.12.1 / 1.12.2 / 1.13 / 1.13.1 / 1.13.2 / 1.14 / 1.14.1 / 1.14.2 / 1.14.3 / 1.14.4 / 1.15 / 1.15.1 / 1.15.2 / 1.16 / 1.16.1 / 1.16.2 / 1.16.3 / 1.16.4 / 1.16.5 / 1.17 / 1.17.1 / 1.18 / 1.18.1 / 1.18.2 / 1.19 / 1.19.1 / 1.19.2 / 1.19.3 / 1.19.4 / 1.20 / 1.20.1 / 1.20.2 / 1.20.3 / 1.20.4 / 1.20.5 / 1.20.6 / 1.21 / 1.21.1 / 1.21.2 / 1.21.3 / 1.21.4 / 1.21.5 / 1.21.6 / 1.21.7 / 1.21.8 / 1.21.9 / 1.21.10 / 1.21.11
Last checked
Updated

LuckPerms is a permissions plugin for Java Minecraft servers maintained by lucko. It runs on Bukkit, Spigot, Paper, BungeeCord, Velocity, and Waterfall through the Modrinth release, and on Sponge, Fabric, Forge, NeoForge, and Nukkit through the builds published on luckperms.net. The plugin organises players into groups, applies permissions and metadata through commands or config, and supports inheritance, contexts, and per-world overrides.

On a Paper or Spigot server it covers the usual admin needs: granting commands, building rank ladders, setting prefixes and suffixes, and limiting access to plugin features. On a proxy like BungeeCord or Velocity it can synchronise permissions across backend servers so a player's rank follows them between lobbies, survival, and minigame nodes.

What it gives you

  • Group inheritance, weights, and per-server or per-world overrides for fine-grained rank trees.
  • Contexts so permissions can change based on world, gamemode, or other registered context calculators.
  • A web editor at editor.luckperms.net that loads a snapshot of the data, lets you make changes in a browser, and applies them back with a single command.
  • Prefix, suffix, and meta values usable from chat plugins, scoreboards, and tab list formatters.
  • Audit log of permission changes, rollback to earlier states, and verbose tracing of permission checks at runtime.

Storage and data options

LuckPerms keeps its data outside the plugin folder by default so it can be shared between servers or proxies in a network. The storage backend is selected in config.yml.

  • Flat file: YAML, JSON, or HOCON, useful for single-server setups.
  • SQL: MySQL, MariaDB, PostgreSQL, H2, or SQLite for shared storage across a network.
  • MongoDB for document-store deployments.
  • Optional messaging service (SQL, Redis, RabbitMQ, NATS, plugin messages) so multiple servers pick up changes without restarts.

Installing on Paper, Spigot, or Bukkit

  1. 1.Download the Bukkit/Spigot/Paper build for your Minecraft version from the Modrinth project page or luckperms.net.
  2. 2.Drop the jar into the server's plugins folder and start the server once so LuckPerms generates its config.
  3. 3.Stop the server, open plugins/LuckPerms/config.yml, and pick a storage method. The default YAML storage works without extra setup.
  4. 4.Start the server again and run /lp creategroup <name> to add your first group, then /lp user <player> parent add <group> to assign it.
  5. 5.Use /lp editor to open the web editor and shape the rest of your permissions visually.

Proxy setup

Install the matching BungeeCord or Velocity build on the proxy and point every backend server at the same storage backend. Network-wide groups, prefixes, and meta then load from one place. On Velocity, the messaging service is what keeps backend servers reactive when ranks change on the proxy.

Questions about this entry.

  • Does LuckPerms need Vault?

    On Bukkit, Spigot, and Paper, LuckPerms registers a Vault permissions provider automatically when Vault is installed. Vault is not required for LuckPerms itself, but most chat, economy, and protection plugins still expect Vault to read permissions and prefixes.

  • Can the same database power a proxy and backend servers?

    Yes. Install the LuckPerms build for each platform, set every instance to the same storage backend in config.yml, and enable a messaging service so changes propagate immediately.

  • Where is the web editor?

    Run /lp editor from a server that has LuckPerms installed. The command uploads a snapshot, gives you a one-time link to editor.luckperms.net, and applies your edits when you press save.