LuckPerms setup for beginners: groups, ranks and permissions

LuckPerms is the permissions plugin most servers use. It lets you create ranks, decide what each rank may do and change it live without restarting. This is the shortest path to a working rank setup.

The idea: groups and nodes

A group is a rank such as default, vip or moderator. A permission node is a name like kits.vip. You give nodes to groups, then put players into groups. Players inherit what their group has.

Install it

Put the LuckPerms jar in the plugins folder and restart. It creates a default group that every new player belongs to. Run /lp info in the console to confirm it loaded.

The commands you need

/lp creategroup vip
/lp group vip permission set kits.vip true
/lp group default permission set homes.use true
/lp user Steve parent add vip
/lp user Steve info

The first line makes the rank, the next two give it permissions, the fourth puts a player in it and the last shows what that player has.

Use the web editor

Typing commands for every node is slow. /lp editor opens a link to a web page where you can see all groups and nodes, change them in a table and apply the result back to the server.

Why does a player get "no permission"?

• The node name is different from what the plugin checks. Read the plugin's plugin.yml or documentation.
• The player is not in the group you changed.
• A more specific rule says false and wins over a general true.
• LuckPerms has a verbose mode that prints every check, so you can see exactly which node was asked for.

Plugins you make yourself

When you generate a plugin, ask for clear permission nodes and a default for each. Then LuckPerms can control them like those of any other plugin.

A starter rank structure

1. default: everyone, with basic commands such as homes and kits.starter.
2. vip: inherits default and adds kits.vip and a higher home limit.
3. moderator: inherits vip and adds moderation commands.
4. admin: inherits moderator and adds the rest, with care.

Use inheritance so that a higher rank automatically has what the lower ones have. Then you only add the differences.

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

Frequently asked questions

Do I need Vault for LuckPerms?

Only if other plugins use Vault to read ranks or prefixes. LuckPerms works without it for permission checks.

How do I take a rank away?

Use /lp user <name> parent remove <group>, and the player returns to the default group.

Is the web editor safe?

It uses a temporary link created by the server. Do not share the link, because it lets someone change your permissions.