Server · Permissions

How to Set Up LuckPerms Ranks

LuckPerms is the standard permissions plugin for Paper and Spigot. Build a clean rank ladder from the console, create a group, set nodes with /lp group set, chain inheritance, and drop players in.

server console,  LuckPerms
/lp creategroup admin█
permission tree
┐defaultw 0
└─modw 50
└─adminw 100
└─user: Stevew → admin
✓ inheritance resolved

The rank ladder, briefly

1
Install and create a group
Drop LuckPerms in /plugins, restart, then run /lp creategroup admin to make your first rank.
2
Grant permissions
Use /lp group admin permission set essentials.fly true. Wildcards like worldedit.* grant whole node trees at once.
3
Set a weight
/lp group admin setweight 100 decides rank order so prefixes and ties resolve highest-first.
4
Chain inheritance
/lp group admin parent add mod makes admin inherit every node mod has, so you never repeat permissions.
5
Assign players
/lp user Steve parent add admin puts a player in the rank. Verify with /lp user Steve permission check worldedit.region.

What you need

/lp creategroup

/lp group set

setweight

parent add

Quick answers

What is the command to set a permission?

/lp group <group> permission set <node> true. Example: /lp group admin permission set essentials.fly true. Use false to explicitly deny a node, and unset to remove it entirely.

How do ranks inherit from each other?

Run /lp group admin parent add mod. The admin group then gets every permission mod has on top of its own, so you build a ladder: default to mod to admin without copying nodes.

What does weight do?

Weight sets priority. /lp group admin setweight 100 makes admin outrank a mod at weight 50, which controls which prefix and which conflicting node wins.

How do I give a player a rank?

/lp user Steve parent add admin, or /lp user Steve parent set admin to replace all their groups. Changes apply live; no relog needed in most cases.

Why isn't my permission working?

Check for an explicit false override with /lp user Steve permission check <node>. A deny set anywhere in the inheritance chain beats a true unless its weight is higher. Also confirm the plugin actually registers that node.

Do I need a database for LuckPerms?

No. LuckPerms works on flat-file H2 out of the box. Move to MySQL only when you run a network and need ranks shared across servers via /lp editor sync.

Groups, inheritance and the order permissions resolve in

Ranks are groups, and players inherit from them

A rank in LuckPerms is a group with permissions attached, and a player gets those permissions by being added to the group rather than by having them set individually. Setting a node on a player directly works and is almost always the wrong move, because the next twenty players need the same thing and nobody will remember where it was set.

Inheritance saves you from copying nodes

A member group can inherit from default, moderator from member, admin from moderator, and each level only lists what it adds. When a permission has to be taken back from one level, a negated node beats deleting it from the parent, because deleting it removes it from everyone below as well.

Weight decides who wins on a tie

When two groups grant conflicting things, the one with the higher weight takes precedence, and weight is also what orders prefixes in chat. A rank ladder without weights set looks fine until two staff groups disagree, and then the result depends on load order rather than on your intent.