Set Up Ranks & Permissions (LuckPerms)
Create ranks like VIP and Admin on your Minecraft server with LuckPerms. Add permissions, prefixes, inheritance and use the web editor on RealisticNode.
LuckPerms decides what each player is allowed to do. You put players into groups (ranks) like default, vip and admin, and give each group the permissions it needs. It's the most used permissions plugin and works with almost every other plugin.
Plugin servers only
LuckPerms works on Paper, Purpur, Spigot, Folia and Velocity. There are also versions for Fabric, Forge and NeoForge if you run a modded server.
Install LuckPerms
Install the plugin
Open Plugins, search for LuckPerms and install it. See Install plugins.
Restart the server
Restart and check the Console: you'll see LuckPerms load. A group called default is created automatically, and every player is in it.
Give yourself full access
In the Console, type (without the /):
lp user YourName permission set * trueNow you can use every LuckPerms command in game with /lp.
* means every permission of every plugin. Only give it to yourself or the server owners, never to a normal rank.
Create your ranks
A common setup is three groups: default (everyone), vip and admin. Run these commands in the Console:
lp creategroup vip
lp creategroup admin
lp group vip parent add default
lp group admin parent add vipThe parent add lines set up inheritance: vip gets everything default has, and admin gets everything vip has. This way you never have to copy permissions between ranks.
To make sure LuckPerms knows which rank is "higher", give them a weight (higher number = more important):
lp group vip setweight 10
lp group admin setweight 100Add permissions
Each plugin lists its permissions on its download page or wiki. Add them with permission set:
lp group default permission set essentials.home true
lp group vip permission set essentials.fly true
lp group admin permission set worldedit.* true- Use
falseinstead oftrueto deny a permission (for example to take something away from a rank that inherits it). permission unsetremoves a permission you added.- Not sure which permission a command uses? Type
lp verbose on, use the command in game, thenlp verbose off. LuckPerms shows every permission that was checked.
Assign players to a rank
| Command | What it does |
|---|---|
lp user Steve parent add vip | Adds the vip rank (Steve keeps his other groups). |
lp user Steve parent set vip | Makes vip Steve's only rank. |
lp user Steve parent remove vip | Removes the rank. |
lp user Steve parent addtemp vip 30d | Gives vip for 30 days, then removes it automatically. |
lp user Steve info | Shows Steve's ranks and prefix. |
Prefixes and suffixes
A prefix is the tag shown before a player's name in chat, like [VIP] Steve. Set it on the group:
lp group vip meta setprefix 10 "&a[VIP] "
lp group admin meta setprefix 100 "&c[Admin] "The number is the priority: if a player has several prefixes, the highest one is shown. &a, &c... are color codes. Use meta setsuffix the same way for text after the name.
Prefixes need a chat plugin
LuckPerms only stores prefixes. To show them in chat, install Vault plus a chat plugin such as EssentialsX Chat (see EssentialsX) or LPC. Restart after installing.
The web editor
Typing commands gets slow with many ranks. The web editor lets you change everything in your browser:
- In the Console (or in game), type
lp editor. - Open the link LuckPerms gives you.
- Add or remove groups, permissions, prefixes and players.
- Click Save. The editor shows a command like
lp applyedits AbC123. - Paste that command into the Console to apply your changes.
Tracks (promotion ladders)
A track is an ordered list of ranks, useful for staff or ranks players climb over time:
lp createtrack staff
lp track staff append helper
lp track staff append moderator
lp track staff append admin
lp user Steve promote staffpromote moves Steve up one step on the track, demote moves him down.
Store data in MySQL
By default LuckPerms saves its data in a local file (H2), which is fine for a single server. If you run several servers (for example behind Velocity) and want them to share ranks, use a database. Follow MySQL Databases, which includes a LuckPerms example.
On a Velocity proxy, the commands start with lpv instead of lp.
Troubleshooting
Check the exact permission with lp verbose on. Also check that the player is really in the group with lp user Name info, and that no group denies it with false.
Install Vault and a chat plugin (EssentialsX Chat or LPC), then restart. If it still doesn't show, check the chat format in that plugin's config.
Editor sessions expire after some time. Run lp editor again, make your changes and save.