Set Up Permissions with LuckPerms

LuckPerms is the most widely used permissions plugin for Minecraft servers. It lets you create groups (ranks), assign permissions and determine exactly which players can use which commands. The plugin works on Paper, Spigot, Fabric and Velocity and replaces older plugins such as PermissionsEx and GroupManager.

Why LuckPerms?

With the default Minecraft op system, a player can either do everything or nothing. That becomes inconvenient as soon as you want to appoint moderators, VIP players or builders, each with their own permissions. LuckPerms solves this with a group system featuring inheritance, a convenient web editor and support for chat prefixes.

Installation

1. Download the correct version of LuckPerms for your server type (Bukkit/Paper, Fabric or Velocity) from luckperms.net.
2. Upload the .jar file to the plugins folder via the Files tab in the game panel, or via SFTP.
3. Restart the server. LuckPerms automatically creates its configuration files in plugins/LuckPerms/.

Creating Groups

Groups form the foundation of your rank system. By default, a default group exists that every new player is assigned to. Create additional groups via the console or in-game:

/lp creategroup vip
/lp creategroup moderator
/lp creategroup admin

Setting Up Inheritance

With inheritance, a higher rank automatically receives the permissions of the lower rank:

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

This way, permissions that apply to everyone only need to be set on default.

Assigning Permissions

Grant permissions to a group with the command /lp group [group] permission set [node] true. Some examples:

• /lp group default permission set essentials.home true
• /lp group default permission set essentials.spawn true
• /lp group moderator permission set essentials.kick true
• /lp group moderator permission set essentials.mute true
• /lp group moderator permission set coreprotect.inspect true
• /lp group admin permission set essentials.ban true
• /lp group admin permission set worldedit.* true

Which nodes you need depends on your plugins. Most plugins list their permission nodes on their download page or in their documentation.

Assigning Players to a Group

• /lp user PlayerName parent set vip replaces the current group with VIP.
• /lp user PlayerName parent add moderator adds moderator without removing the existing group.

The Web Editor

LuckPerms includes a powerful web editor that lets you manage groups, permissions and inheritance visually. Type /lp editor in the console and open the link in your browser. Make all your changes, click Save and the changes are applied to the server immediately. This is often faster and clearer than typing individual commands.

Chat Prefixes

If you want to show rank names in chat, such as [Admin] or [VIP], set up a prefix:

/lp group admin meta setprefix "&c[Admin] "
/lp group vip meta setprefix "&a[VIP] "
/lp group moderator meta setprefix "&b[Mod] "

You need a chat plugin that supports prefixes, such as LPC (LuckPerms Chat Formatter) or Vault in combination with EssentialsX Chat.

Commonly Used Permission Nodes

• essentials.home, essentials.spawn, essentials.tpa for basic features
• essentials.kick, essentials.mute, essentials.ban for moderation
• worldguard.region.claim for area protection
• coreprotect.inspect, coreprotect.rollback for log management

Tips for HostValues Customers

• Edit the LuckPerms configuration via the Files tab in the game panel or via SFTP. The files are located in plugins/LuckPerms/.
• Grant yourself all permissions by adding yourself to the admin group first via the console in the panel.
• For a network with multiple servers, connect LuckPerms to the MySQL database of your server so all servers share the same permissions.
• Always make a backup before making major changes to your permissions.