Back to Blog
Rangées de clés anciennes sur fond jaune, symbole des rangs et permissions gérés avec LuckPerms
Published on 10/19/2026

LuckPerms tutorial: set up ranks and permissions step by step

LuckPerms is the go-to permissions plugin for Minecraft servers running Spigot, Paper or Purpur, but its commands can feel cryptic at first. This tutorial takes you from installation to a full Player, VIP, Moderator and Admin hierarchy, with copy-paste rank templates, the web editor and fixes for the most common problems.

What LuckPerms does, and what it doesn't

LuckPerms decides who can do what. Every command or feature of a plugin is guarded by a permission, a simple string such as essentials.fly. A permission can be true (granted), false (explicitly denied) or undefined, which almost always behaves like a denial.

Four concepts are all you need:

  • Group: a set of permissions you assign to players. One rank equals one group.
  • Inheritance (parent): a group can inherit from another. If "admin" inherits from "moderator", it gets all of the moderator's permissions.
  • Weight: a number that ranks groups. The higher it is, the higher the priority.
  • Context: a condition, such as world=world_nether for a permission that only applies in the Nether.

The key point many guides skip: LuckPerms stores prefixes but does not display them. To see "[Admin]" in front of a name in chat, you also need Vault and a chat formatting plugin such as EssentialsX Chat. More on that below.

Install LuckPerms on Spigot, Paper or Purpur

As of October 2026, the current release is 5.5.87 (5.5 series), which supports Minecraft 1.8.9 up to 26.3 according to the project's official metadata.

  1. Download the Bukkit build from the official LuckPerms download page. It is the one that runs on Spigot, Paper and Purpur.
  2. Start your server once so the plugins folder exists, then upload the .jar file there with your panel's file manager.
  3. Do a full restart (stop, then start again). Avoid /reload, which often leaves plugins in a broken state.

By default, LuckPerms stores its data in an H2 database (the luckperms-h2-v2.mv.db file, do not delete it). If you prefer readable files, set storage-method to yaml in plugins/LuckPerms/config.yml before creating your ranks. For a network of several servers, use MySQL instead.

Step 1: give yourself full access

Right after installation, nobody can use LuckPerms commands, not even you. Open the server console (no slash needed there):

lp user YourName permission set luckperms.* true

The * wildcard grants every permission starting with luckperms.. You can then carry on in game with /lp.

Step 2: plan your rank hierarchy

Before typing a single command, sketch your structure. Here is the one we are going to build:

RankGroupWeightInherits fromPrefix
Playerdefault0none&7[Player]
VIPvip10default&6[VIP]
Moderatormoderator50vip&9[Mod]
Adminadmin100moderator&c[Admin]

The default group already exists and every player is in it automatically. The official documentation advises against replacing it with another group; if the name bothers you, just change its display name with /lp group default setdisplayname Player.

Step 3: create the groups and inheritance

The creategroup command takes the weight as an optional second argument:

/lp creategroup vip 10
/lp creategroup moderator 50
/lp creategroup admin 100

/lp group vip parent add default
/lp group moderator parent add vip
/lp group admin parent add moderator

Inheritance is recursive: the admin gets the moderator's permissions, therefore the VIP's and the player's too. You never have to repeat a permission across groups. For an existing group, set the weight with /lp group vip setweight 10.

Step 4: ready-made rank templates

These templates use EssentialsX permissions, the most widely used utility plugin. Adapt them to your own plugins, whose documentation always lists their permissions.

Player (default group)

/lp group default permission set essentials.spawn true
/lp group default permission set essentials.home true
/lp group default permission set essentials.sethome true
/lp group default permission set essentials.tpa true
/lp group default permission set essentials.tpaccept true
/lp group default permission set essentials.tpdeny true
/lp group default permission set essentials.msg true
/lp group default permission set essentials.balance true
/lp group default permission set essentials.pay true

VIP

VIPs get quality-of-life perks, nothing that breaks game balance:

/lp group vip permission set essentials.hat true
/lp group vip permission set essentials.workbench true
/lp group vip permission set essentials.back true
/lp group vip permission set essentials.nick true
/lp group vip permission set essentials.sethome.multiple true
/lp group vip permission set essentials.sethome.multiple.vip true

The last two lines allow several homes. The exact number is set in the sethome-multiple section of the EssentialsX config.yml (5 for "vip" in the default configuration). Both permissions are required.

Moderator

/lp group moderator permission set essentials.kick true
/lp group moderator permission set essentials.mute true
/lp group moderator permission set essentials.tempban true
/lp group moderator permission set essentials.tp true
/lp group moderator permission set essentials.invsee true
/lp group moderator permission set essentials.vanish true
/lp group moderator permission set essentials.socialspy true

Moderators can ban temporarily but not permanently, a simple safeguard against mistakes and abuse.

Admin

/lp group admin permission set essentials.* true
/lp group admin permission set minecraft.command.* true
/lp group admin permission set luckperms.* true

Only give luckperms.* to people you fully trust: with it, anyone can grant themselves any permission. And never hand the global * permission to a moderation rank.

Blocking an inherited permission

A false value removes a permission a group inherits. Example: VIPs can fly everywhere except in the Nether, thanks to a context:

/lp group vip permission set essentials.fly true
/lp group vip permission set essentials.fly false world=world_nether

Step 5: prefixes and chat display

Give each group a prefix. The priority (the first number) decides which prefix wins when a player inherits several: the highest one is used. Keeping it equal to the weight makes things easy to read.

/lp group default meta setprefix 0 "&7[Player] "
/lp group vip meta setprefix 10 "&6[VIP] "
/lp group moderator meta setprefix 50 "&9[Mod] "
/lp group admin meta setprefix 100 "&c[Admin] "

The quotes keep the trailing space. setprefix replaces the existing prefix in the same context, while addprefix adds another one.

To actually see these prefixes, install Vault and a Vault-compatible chat plugin: EssentialsX Chat if you already use EssentialsX, or VaultChatFormatter for something minimal. For the tab list and name tags, you need a dedicated plugin such as TAB.

Step 6: assign ranks to players

# Add a rank (other ranks are kept)
/lp user Steve parent add vip

# Replace all ranks with a single one
/lp user Steve parent set moderator

# VIP for 30 days, removed automatically afterwards
/lp user Alex parent addtemp vip 30d

# Remove a rank
/lp user Steve parent remove vip

Durations can be combined: 1mo3d12h means one month, three days and twelve hours. To check the result, /lp user Steve info shows the groups, the primary group and the prefix actually passed to other plugins.

Step 7: a track to promote your staff

A track is an ordered ladder of groups. It saves you from removing and adding groups by hand on every promotion:

/lp createtrack staff
/lp track staff append moderator
/lp track staff append admin

/lp user Steve promote staff
/lp user Steve demote staff

If Steve is not on any group of the track yet, promote puts him on the first one (moderator). The next promotion makes him admin and removes the moderator group automatically.

The fast way: the /lp editor web editor

If typing commands feels tedious, the web editor does everything in your browser, with permission autocomplete:

  1. Run /lp editor (or /lp editor groups for groups only, /lp group vip editor for a single group).
  2. Click the link you receive in chat or in the console.
  3. Add permissions in the "Add Permission" box; you can paste several at once. Click a value to edit it, or "Add Contexts" to limit it to a world.
  4. Save with "Save" or Ctrl+S. The editor generates a /lp applyedits <code> command: run it on the server to apply the changes.

In the editor you can also manage ranks as nodes: group.vip for a parent, weight.10 for the weight, prefix.10.&6[VIP] for a prefix, displayname.Player for a display name. Never share an editor session link publicly: it gives access to your permission data.

Troubleshooting: the most common problems

"I can't find the right permission"

Use verbose mode, the most reliable method. Run /lp verbose record Steve, have Steve run the problematic command, then type /lp verbose upload. You get the exact list of permissions that were checked and their result.

The prefix doesn't show in chat

Check /lp user Steve info first. If the prefix is listed there, LuckPerms is working and the issue is on the display side: Vault is missing, or the chat plugin is missing or misconfigured. The /vault-info command should show that chat data comes from LuckPerms.

A player has a permission they shouldn't

Most of the time they are an operator (/op): ops automatically get every permission a plugin reserves for operators by default. Remove it with /deop and manage everything through LuckPerms. Otherwise, track down the source with /lp user Steve permission check essentials.fly.

My changes don't apply

If something was changed outside the server (YAML files edited by hand, shared database), reload the data with /lp sync.

Test everything on a free server

LuckPerms needs almost no resources. You can build and test your whole rank structure on a free MineServerGratis Minecraft server running Paper, Spigot or Purpur before opening it to your community.

FAQ

Is LuckPerms free?

Yes, LuckPerms is free and open source on every supported platform.

Do I need Vault to use LuckPerms?

Not for permissions themselves. You do as soon as another plugin (chat, economy, tab list) needs to read groups or prefixes through Vault.

How do I rename the default group?

You don't: give it a display name with /lp group default setdisplayname Player, or make it inherit from a "member" group with /lp group default parent add member.

What is the difference between parent add and parent set?

parent add adds a group and keeps the others; parent set removes all existing groups and keeps only the new one.

Can I give a rank for a limited time?

Yes, with /lp user Name parent addtemp vip 30d. The rank disappears on its own when it expires.