Back to Blog

LuckPerms Guide: Ranks and Permissions on a Minecraft Server

A LuckPerms guide for Paper servers: installation, groups and inheritance, prefixes, temporary ranks, promotion tracks, the web editor and storage options.

Nodesty Team7 min readGame servers
The word LuckPerms with groups, permissions and prefixes on a dark Nodesty background

LuckPerms is the most widely used permissions plugin for Minecraft servers: it lets you split players into groups such as default, VIP and moderator, give each group exactly the commands it needs, add chat prefixes and hand out ranks for a limited time. In this guide, we set up LuckPerms on a Paper server step by step and build a simple rank structure.

The commands below work the same on Spigot and Paper. If you haven't set up a server yet, start with our How to make a Minecraft server guide.

Why OP isn't enough

Vanilla Minecraft only knows OP: a player is either an operator with access to almost every command or a normal player. You can't let a moderator kick players without also letting them stop the server, and plugin commands follow the same all-or-nothing rule. We explain OP levels in our Minecraft server commands guide.

A permissions plugin replaces this with permission nodes. Every plugin command checks a node such as essentials.home or essentials.kick, and LuckPerms decides which players and groups have it.

Installing LuckPerms

  1. Download the right build from the official site, luckperms.net/download:
    • Bukkit for Paper, Spigot and Purpur servers
    • Velocity or BungeeCord for a proxy
  2. Put the .jar file in the server's plugins folder.
  3. Restart the server (don't use reload).

On first start LuckPerms creates the plugins/LuckPerms folder with its config.yml and a local database. Check with plugins in the console that LuckPerms is listed in green.

The first command: giving yourself access

LuckPerms commands start with /lp (/luckperms and /perms work too). Right after installation nobody has LuckPerms permissions, so give your own account full access from the server console, without a slash:

lp user Alex permission set luckperms.* true

Now you can use /lp in game. Once your access works, remove OP from yourself with deop Alex; otherwise OP gives you every permission anyway and you can't test your ranks properly.

The web editor

Typing every node by hand is slow. The web editor shows groups, users and permissions in the browser:

/lp editor

LuckPerms prints a link. Make your changes in the browser and click Save. Recent versions apply the changes to the server immediately; otherwise the editor shows an /lp applyedits <code> command that you run on the server. The rest of this guide uses commands, since they are easier to copy, but everything can also be done in the editor.

Creating groups

Every player is in the default group automatically. Give it the basic permissions for all players:

/lp group default permission set essentials.home true
/lp group default permission set essentials.sethome true
/lp group default permission set essentials.spawn true

Create new groups and let them inherit from each other, so that you don't repeat permissions:

/lp creategroup vip
/lp group vip parent add default
/lp group vip permission set essentials.fly true

/lp creategroup moderator
/lp group moderator parent add vip
/lp group moderator permission set essentials.kick true
/lp group moderator permission set essentials.mute true

The moderator group now has its own permissions plus everything from vip and default.

Adding players to groups

/lp user Alex parent set vip
/lp user Alex parent add builder
/lp user Alex parent remove builder
  • parent set removes the player's other groups and leaves only the one you give.
  • parent add adds a group on top of the existing ones.

The player must have joined the server at least once. Changes apply immediately; the player doesn't need to reconnect.

Weights and prefixes

When a player is in several groups, the weight decides which group wins: higher weight means higher priority. Give each rank a clear weight:

/lp group default setweight 0
/lp group vip setweight 10
/lp group moderator setweight 50

Prefixes are set as meta with a priority; the prefix with the highest priority is shown:

/lp group vip meta setprefix 10 "&6[VIP] "
/lp group moderator meta setprefix 50 "&9[Mod] "

&6 and &9 are Minecraft color codes, and the space inside the quotes keeps the prefix apart from the name.

Important: LuckPerms stores the prefix but doesn't format chat itself. To see it in chat, you need a chat plugin that reads prefixes, for example EssentialsX Chat together with Vault, or another chat plugin that supports LuckPerms. Tab list and nametag prefixes need their own plugin too.

Temporary permissions and ranks

For a VIP purchase or a trial moderator, add a duration. LuckPerms removes the entry when the time is up:

/lp user Alex parent addtemp vip 30d
/lp user Alex permission settemp essentials.fly true 7d

Durations are written like 30m, 12h, 7d or combined, such as 1d12h.

Tracks: promoting staff step by step

A track is an ordered list of groups. It makes promotion a single command:

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

/lp user Alex promote staff
/lp user Alex demote staff

promote moves the player to the next group on the track, demote to the previous one. Create the helper and admin groups first, like the groups above.

Taking permissions away and wildcards

Setting a node to false negates it, even if the player would inherit it from another group:

/lp group vip permission set essentials.fly false
/lp user Alex permission unset essentials.fly

unset removes the entry completely, which is different from setting it to false.

Wildcards such as essentials.* give every permission of a plugin, including admin commands you may not want to share. Never give * to any group except perhaps the owner: it grants everything, LuckPerms commands included.

Finding permission nodes

  • Plugin documentation: Most plugins list their nodes on their wiki or download page.
  • Verbose mode: Run /lp verbose on, let a player use the command and watch which nodes are checked; turn it off with /lp verbose off.
  • Permission tree: /lp tree uploads a browsable list of the nodes registered on your server.

Checking what a player has

/lp user Alex info
/lp user Alex permission check essentials.fly
/lp group vip info

info shows the player's groups and prefix; permission check shows whether a node is true or false and where it comes from.

Storage: H2 or MySQL/MariaDB

By default LuckPerms stores data in a local H2 file in plugins/LuckPerms. That's ideal for a single server. For a network with several servers behind a proxy, connect every LuckPerms install to the same database in config.yml:

storage-method: mariadb
data:
    address: 127.0.0.1:3306
    database: luckperms
    username: luckperms
    password: 'strong-password'
messaging-service: sql

The messaging service tells the other servers when data changes. Database setup is covered in our MySQL and MariaDB installation guide, and the network itself in our Minecraft Velocity network guide.

Backups with export and import

/lp export luckperms-backup
/lp import luckperms-backup

The export file is written to the plugins/LuckPerms folder. It's also the easiest way to move from H2 to MariaDB: export, change the storage, restart and import.

Common mistakes

  • Leaving OP on: OP players automatically get most plugin permissions, so you can't tell whether a rank really works.
  • Giving * or broad wildcards: A VIP with essentials.* can ban players.
  • Editing storage files while the server is running: Make changes through commands or the editor, or stop the server first.
  • Forgetting the chat plugin: Prefixes are stored correctly but never shown.

Once your ranks are in place, our How to grow a Minecraft server guide helps you fill them with players.

A Minecraft server at Nodesty

Nodesty Minecraft server hosting plans run in Frankfurt on an AMD Ryzen 9 9950X processor reaching 5.7 GHz, with NVMe storage and DDoS protection. You can start with Paper in minutes, upload LuckPerms to the plugins folder and manage your ranks with full admin access. Daily backups on game servers are free and kept for 7 days.

Minecraft is a trademark of Mojang AB. LuckPerms is an independent open-source project. Nodesty is not affiliated with or endorsed by Mojang, Microsoft or the LuckPerms project.

Frequently Asked Questions

Why can't I use the lp command after installing LuckPerms?

LuckPerms commands need the matching luckperms permissions, and a fresh install has no groups with those permissions yet. Run lp user followed by your name and permission set luckperms.* true from the server console once, then you can use the commands in game.

I set a prefix but it doesn't show in chat. Why?

LuckPerms only stores the prefix; it doesn't change the chat format itself. You need a chat plugin that reads prefixes, such as EssentialsX Chat together with Vault, or another chat plugin with LuckPerms support. The tab list needs its own plugin as well.

What is the difference between parent set and parent add?

parent set removes the player's other groups and leaves only the group you give. parent add adds the group on top of the existing ones. For a simple rank system parent set is usually what you want; for extra roles such as builder, use parent add.

How do I give a rank for 30 days only?

Use lp user followed by the player name and parent addtemp vip 30d. LuckPerms removes the group automatically when the time is up, even if the server was offline in the meantime, so you don't need to remember to remove it.

Should I use H2 or MySQL for LuckPerms?

For a single server the default H2 file is enough and needs no setup. If you run several servers behind Velocity or BungeeCord and want the same ranks everywhere, connect all LuckPerms installs to one MySQL or MariaDB database.

Do I still need OP after installing LuckPerms?

No. Once your own account has the permissions it needs through LuckPerms, remove OP with the deop command. OP players automatically get most plugin permissions, which hides whether the ranks you built really work.

Nodesty

About the author

Nodesty Team · Infrastructure & Support

The Nodesty team runs our servers, network and DDoS protection day to day and answers customer support requests around the clock. These guides come from that work.

Related articles

Launch your server now.

Build, scale, and conquer without limits on Nodesty's premium infrastructure.

                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                                                                                                                            
                                                                                                                             ············································                                                   
                                                ··································································································..........···························                                     
                                       ················..........................................................................................................................··············                             
                                  ·············.................::::::::::::::::::::::::::::::::::::::::::::::....................:::::::::::::::::::::::::::::::::::::::................···········                        
                             ············................:::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::............·········                     
                         ············.................:::::::::::::::::::::::::::::::::::::::::::::::::::------------::::::::::::::::::::::::::::::----------------:::::::::::::::::::::..........········                  
                    ············......................::::::::::::::::::::::::::::::::::::------------------------------------------------------------------------------------:::::::::::::.........········                
                ··········.............................................::::::::::::::::::-------------==========================================-----------------------------------:::::::::::........·······               
             ········..................:.....................................::::::::::--------=======+++++++++++++++++++++++++++++++++++++=========================------------------::::::::::.......·······              
           ······.........::::::::::::::::::::................................:::::::-----=====++++xxxxxx**************************xxxxxxxxx++++++++++++++===================------------::::::::.......·······             
          ·····.......:::::::::::::::::::::::::::.............................:::::----===+++xxx****%%%%&&&&&&#############&&&&&&&%%%%%*******xxxxxxxx++++++++++++++==============----------:::::::......······             
         ····......::::::::-------------:::::::::::..........................::::---===+++xx***%%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@####&&&&&%%%%*******xxxxxxxxx+++++++++++++===========--------::::::......·····             
        ····.....:::::::--------------------:::::::::.......................::::---===++xxx**%%&&&###@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&%%%%%********xxxxxxxxxxx++++++++++++========------::::::.....······            
        ····.....:::::--------------------------::::::::....................::::---===++xx***%%&&&####@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@###&&&&&%%%%%**********xxxxxxxxxxxxx+++++++++=======------:::::.....·····            
        ····....::::::-------=============---------:::::::::................:::::---===+++xx***%%%&&&#####@@@@@@@@@@@@@@@@@@@@@@@@@#####&&&&&%%%%%%*************xxxxxxxxxxxxxx+++++++++======-----:::::....·····            
         ····....:::::-------================---------:::::::::...............:::::----===++++xxx***%%%%&&&&&&#################&&&&&&%%%%%%%*******************xxxxxxxxxxxxxxxxx++++++++======----:::::....·····            
         ·····....:::::--------=================---------::::::::::..............:::::::-----====+++++xxxxxx**************************xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx++++++++=====-----::::....·····            
          ·····.....:::::--------=================----------:::::::::::.................:::::::::-------=============++++++++++++++++++++++++++++++++++++xxxxxxxxxxxxxxxxxxxxxxx++++++++======-----::::....·····            
            ·····.....:::::::----------===========-------------::::::::::::.........................::::::::::::::::::------------------=============+++++++++++++++++++++++++++++++++=======-----::::.....·····            
              ······......:::::::---------------------------------:::::::::::::........................................:::::::::::::::-----------============+++++++++++++++++++++========------:::::.....·····             
                 ······........:::::::::---------------------------:::::::::::::::::...........................................:::::::::::::------------=============================--------::::::.....······              
                    ·········.........:::::::::::::::-------------::::::::::::::::::::::::.......................................::::::::::::::::--------------------------------------::::::::......·······                
                          ··········............::::::::::::::::::::::::::::::::::::::::::::::::::................................::::::::::::::::::::::::::-------------:::::::::::::::.........········                   
                                  ············..................:::::::::::::::::::::::::::::::::::::::::::.........................:::::::::::::::::::::::::::::::::::::................···········                        
                                             ················.............................................................................................................·················                                 
                                                           ······················................................................................···························                                                
                                                                               ·········································································