Context
On a Minecraft server, giving operator status to every moderator hands them every command in the game. LuckPerms solves this by letting you create ranks (VIP, moderator, admin...) that only grant the permissions you choose. A player inherits the rights of their rank, a rank can inherit from another one, and a prefix can be shown in front of the player name.
This guide explains how to install LuckPerms on your Winheberg Minecraft Java server from the panel, give yourself admin rights, create your first ranks and add players to them, either with commands or with the web editor.
Prerequisites
- A Winheberg Minecraft Java server running Paper, Spigot or Purpur
- Access to the Winheberg panel
- The exact username of each player you want to add to a rank (each one must have joined the server at least once)
In the panel console, type commands without a leading /. In game, add the / (for example /lp user PlayerName info).
1. Install LuckPerms from the panel
Log in to the Winheberg panel, select your server and open Plugins in the side menu. Before searching, set Plugin loader to Paper (or to your server software), then type LuckPerms in Search query. Click the download icon on the right of the LuckPerms result.
In the Install plugin window, check that the Plugin version menu shows a version ending in (Bukkit), then click Install plugin. The LuckPerms-Bukkit file is placed in your server's plugins folder.
Without the Plugin loader filter, the panel first offers the Velocity version of LuckPerms, which is meant for proxies. It does not run on a Paper server. If the version name ends in (Velocity) or (BungeeCord), pick the (Bukkit) line in the list.
Then open Console and click Restart. On startup, the console confirms it loaded with the line [LuckPerms] Successfully enabled.
2. Give yourself admin rights
Right after installation, nobody can use LuckPerms commands except the console and operators. From the panel console, give yourself full access to the plugin, replacing YourName with your Minecraft username.
lp user YourName permission set luckperms.* true
You can now use /lp in game, even without being an operator.
3. Create your ranks
In this example, we create a vip rank and a moderateur rank that inherits every permission of the VIP rank. Type these commands in the console, one per line.
lp creategroup vip
lp creategroup moderateur
lp group moderateur parent add vip
lp group moderateur permission set minecraft.command.kick true
lp group moderateur meta setprefix 20 "&9[Modo] "
lp group moderateur setweight 20
Each command is confirmed by an [LP] line in the console.
| Command | Effect |
|---|---|
lp creategroup <rank> |
Creates a new rank |
lp group <rank> parent add <other rank> |
The rank inherits the permissions of the other rank |
lp group <rank> permission set <permission> true |
Grants a permission to the rank (false denies it) |
lp group <rank> meta setprefix <priority> "<prefix>" |
Sets the prefix shown in front of the player name |
lp group <rank> setweight <weight> |
Gives the rank a weight, the highest one wins in case of conflict |
Permission names are listed on each plugin's page, for example essentials.fly for EssentialsX. The * wildcard covers every permission of a plugin, such as essentials.*. Leave large gaps between weights (10, 20, 100...) so you can slot in a new rank later.
Every player belongs to the default rank, which LuckPerms creates automatically. This rank cannot be deleted and holds the basic permissions everyone gets.
4. Add a player to a rank
The player must have joined the server at least once. Add them to the rank you want, then check the result.
lp user PlayerName parent add moderateur
lp user PlayerName info
The parent add command adds the rank without removing the others. To replace all of their ranks with a single one, use lp user PlayerName parent set moderateur. To remove a rank, use lp user PlayerName parent remove moderateur.
The parent set command also removes the default rank. To make sure the player keeps the basic permissions, make your ranks inherit default, for example with lp group vip parent add default.
LuckPerms does not show the prefix in chat by itself. To show it, add Vault and a chat formatting plugin that reads prefixes, such as EssentialsX Chat. See our guide How to install and configure EssentialsX on a Minecraft server.
5. Manage ranks with the web editor
If you would rather click than type commands, LuckPerms offers an editor in your browser. Type the following command in the console.
lp editor
The console shows a link to luckperms.net/editor/.... Open it, then select a rank under Groups to view and change its permissions, weight and parent ranks. The screenshots below show the editor in French, but the buttons are in the same place in English.
Once you are done, click Save in the top right corner. The editor generates an lp applyedits command followed by a code. Copy it and paste it into the panel console to apply your changes.
When it opens, the editor may show a window suggesting an lp trusteditor command to apply changes live. This step is optional, so you can close the window and use the Save button instead. After an applyedits, run lp editor again to get a fresh link before you continue.
If you run into trouble
❌ The console replies "A user for ... could not be found"
[LP] A user for PlayerName could not be found.
- Check the spelling of the username (capital letters do not matter)
- Ask the player to join the server once, since LuckPerms only knows players who have already connected
❌ A player cannot use a command despite their rank
- Check they are in the rank with
lp user PlayerName info - Test the permission with
lp user PlayerName permission check <permission> - To find which permission a command needs, type
lp verbose on, have the player run the command, thenlp verbose off - Make sure LuckPerms is the only permissions plugin installed on the server
❌ The /lp command only shows the plugin version
If /lp only shows the plugin version, you have no LuckPerms permission. Go back to step 2 from the panel console.
❌ The prefix does not show in chat
- Install Vault and a compatible chat plugin, such as EssentialsX Chat
- Check with
lp user PlayerName meta infothat the player does not inherit another prefix with a higher priority (the number given inmeta setprefix)
Best practices
- Avoid giving operator to your staff, use a rank with only the permissions they need instead
- Chain your ranks with
parent add(player, VIP, moderator, admin), so each rank only adds its own permissions - Test with a non-operator account to see exactly what a player can do
- Back up before a big change from the Backups tab, LuckPerms stores its data in the
plugins/LuckPermsfolder - Keep a single permissions plugin, as two plugins of this kind on the same server conflict with each other
Need help?
If your ranks do not behave as expected, our team can help. Open a ticket in the Technical department from your client area, fill in the Related Product field with the server in question, and include the commands you used along with the message shown in the console.
Your Minecraft server now has clean, well-organised ranks 🎮


