LuckPerms: set up ranks and permissions

LuckPerms controls who can use which commands and features. You put permissions into groups (ranks such as default, vip, mod and admin) and then put players into those groups. Install it, give yourself access from the console, and build your ranks with commands or the web editor.

Install LuckPerms

1. In the Game Panel, open your server and click Plugins.

2. Search for LuckPerms, click Install and restart the server.

LuckPerms also has versions for Fabric, Forge, NeoForge, Velocity and BungeeCord on luckperms.net/download. Pick the one for your server software.

Give yourself full access

Right after install, nobody can use LuckPerms commands. Open Console and run (replace the name with yours):

lp user YourName permission set luckperms.* true

Key ideas in one minute

• Permission (node): a text like essentials.home that unlocks one feature. Each plugin lists its nodes in its docs.

• Group: a set of permissions. Every player is in the group default automatically.

• Parent: a group a player or another group inherits from. If admin has mod as a parent, admins get everything mods have.

Create ranks with commands

Example: a mod rank that inherits from default, and an admin rank that inherits from mod.

lp creategroup mod
lp creategroup admin
lp group mod parent add default
lp group admin parent add mod
lp group mod permission set minecraft.command.kick true
lp group admin permission set minecraft.command.ban true

Put a player into a rank, or take them out:

lp user Steve parent add mod
lp user Steve parent remove mod

To take a permission away from a group, use unset instead of set, for example lp group mod permission unset minecraft.command.kick. Setting a node to false blocks it on purpose.

Want every new player to have something, like /home? Give it to the default group: lp group default permission set essentials.home true.

Use the web editor (easier on a phone)

1. Run lp editor in the console (or /lp editor in game).

2. Open the link it gives you. You can add groups, permissions and parents with clicks, and it suggests permission names as you type.

3. When you are done, click Save. The editor shows a command.

4. Copy that command and run it in the console or in game. Your changes apply right away.

Find the permission a command needs

Check the plugin's documentation first. If you can't find it, let LuckPerms record it: run lp verbose record Steve, ask Steve to try the command, then run lp verbose paste and open the link to see which permission was checked.

Prefixes in chat

You can store a prefix on a group:

lp group admin meta addprefix 100 "&c[Admin] "

LuckPerms does not change chat by itself. To show prefixes, also install Vault and a chat plugin that reads from Vault, such as EssentialsX Chat. See EssentialsX setup.

Using LuckPerms across a network

On a Velocity or BungeeCord network, install LuckPerms on the proxy and on every backend server, and connect them all to the same MySQL/MariaDB database. You can create one in the Databases tab (see How to create a MySQL database) and put its details in the storage-method and data settings of each LuckPerms config. On the proxy, the command is lpv (Velocity) or lpb (BungeeCord) instead of lp.

Frequently asked questions