Mastering LuckPerms: The Ultimate Guide

LuckPerms is the industry standard for managing ranks, prefixes, and permissions. This guide covers everything from your first group to complex cross-server inheritance.

1. The Web Editor (The Pro Way)

Forget typing endless commands. LuckPerms has a revolutionary web-based UI for managing everything.

1. Type /lp editor in-game.
2. Click the link generated (it is unique and secure).
3. Add your groups, permissions, and prefixes in the browser.
4. Click Save (top right), copy the command provided, and paste it back into your server console.

2. Understanding Group Hierarchy

To create a functional rank system (e.g., Member -> VIP -> Admin), you need Inheritance and Weight.

Group	Parent	Weight	Permissions
Default	None	1	essentials.spawn, essentials.home
VIP	Default	100	essentials.fly, essentials.nick
Admin	VIP	1000	* (All Permissions)

Command Example: /lp group vip parent add default (VIP now has all permissions of Default plus its own).

3. Prefixes & Suffixes

Ranks look best with chat prefixes. You must have a chat plugin (EssentialsXChat or LPC) + Vault installed.

• /lp group admin meta setprefix "&c[Admin] "
• /lp group vip meta setprefix "&b[VIP] "

4. Advanced: Contextual Permissions

You can limit permissions to specific worlds or servers (for BungeeCord/Velocity setups).

This command allows flight only in the "pvp_world".

5. Troubleshooting Why Perms Fail

• OP Conflict: If you are OP, you usually have all perms. De-op yourself to test LuckPerms properly.
• Prefix not showing: Ensure Vault is installed. LuckPerms only stores the prefix; it doesn't display it in chat.
• JSON Error: If you manually edit config.yml and the plugin breaks, use a YAML validator or use the Web Editor instead.