How to Configure LuckPerms on Your Server
Mods & Plugins
·
Nov 2, 2024
LuckPerms is one of the more recent and popular permission managers available for the latest versions of Minecraft. It allows server admins to control what features players can use by creating groups and assigning permissions.
LuckPerms is most commonly used on Spigot/Bukkit servers, however, it is also available for Forge/Fabric servers.
Important
If you are installing LuckPerms on a Forge/Fabric server you can follow our separate installation guide here.
Installing LuckPerms
To install LuckPerms, you can use our built-in plugin installer.
Download LuckPerms here.
Download LuckPerms here.
Access your server's control panel and navigate to the Files tab.
Access your server's control panel and navigate to the Files tab.
Select the plugins folder to open it
Select the plugins folder to open it
Upload the plugin downloaded in step 1.
Upload the plugin downloaded in step 1.
Restart your server.
Restart your server.
Configuring Permissions in LuckPerms
To configure permissions and groups in LuckPerms, you can follow these steps:
Within Minecraft, open the chat and run the command /lp editor.
Within Minecraft, open the chat and run the command /lp editor.
Click on the link that it gives you in chat and click Yes.
Click on the link that it gives you in chat and click Yes.
For the purpose of this tutorial, we are going to use the following groups: default, member, moderator, admin and owner. You can change the group names to fit your liking.
Press on the plus icon next to GROUPS to begin making a group.
Press on the plus icon next to GROUPS to begin making a group.
An explanation of the configuration options are as follows:
Group name: The official name of the group. This is usually used when referencing the group using in-game commands.
Display name: How the name of the group will display in the LuckPerms Editor. Note that this is NOT how the group will appear in-game.
Parent: Which group the group you are creating will inherit. If this is set, the group will have all permissions from the previous group it is inheriting.
Weight: If a player has more than one group assigned to them, the group weight will determine which group will take priority. A higher number means higher priority and will override a lower weight.
Prefix: The tag that will be displayed before the player's username in-game (Note, this requires the plugin "Vault")
Suffix: The tag that will be displayed after the player's username in-game (Note, this requires the plugin "Vault")
After you have created the groups, you can start adding permissions. The permissions you add will be dependent on what plugins you have installed. The most commonly used plugin is EssentialsX and you can find a list of its permission nodes here. In this example, we are going to give the "Member" group the permission bukkit.command.help, which will allow them to use the /help command in-game.
Type in the permission you want to give, and click Add Node.
Type in the permission you want to give, and click Add Node.
Now that you have created a group with a permission, you can assign the group to players.
Assign the rank to your desired players by selecting the player from the Users drop-down and adding the permission node group.groupname.
Assign the rank to your desired players by selecting the player from the Users drop-down and adding the permission node group.groupname.
Note
Alternatively, you can assign groups to players using the following command in-game: /lp user <player-name> group add <group-name>.
Press Save at the top of the page. It is going to show a pop-up with a command. Click it to copy the command.
Press Save at the top of the page. It is going to show a pop-up with a command. Click it to copy the command.
Go back to Minecraft and run the command in-game. This will apply your changes to the permissions.
Go back to Minecraft and run the command in-game. This will apply your changes to the permissions.
That's it! You have successfully configured permissions for your Minecraft server! If you would like to learn how to optimise LuckPerms by using a MySQL database, you can see our other tutorial here.
Zach Lowery
Game Experience Engineer