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 control exactly which players can use which commands. The plugin works on Paper, Spigot, Fabric and Velocity, replacing older alternatives like PermissionsEx and GroupManager.

Why LuckPerms?

With default Minecraft operator rights a player can do everything or nothing. That becomes impractical as soon as you want moderators, VIP players or builders, each with their own set of permissions. LuckPerms solves this with a group system, inheritance, a visual 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 where every new player is placed. 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 you only need to set permissions that apply to everyone on the default group.

Assigning permissions

Grant permissions to a group with the command /lp group [group] permission set [node] true. A few 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 your changes, click Save and they are applied to the server immediately. This is often faster and clearer than typing individual commands.

Chat prefixes

To show rank names in the chat, such as [Admin] or [VIP], set 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 combined with EssentialsX Chat.

Common permission nodes

• essentials.home, essentials.spawn, essentials.tpa for basic features
• essentials.kick, essentials.mute, essentials.ban for moderation
• worldguard.region.claim for region 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 in plugins/LuckPerms/.
• Give yourself full permissions by adding yourself to the admin group via the console in the panel first.
• For a network with multiple servers, connect LuckPerms to your server's MySQL database so all servers share the same permissions.
• Always create a backup before making major changes to your permissions.