Plugins
· 2 min read
LuckPerms Permissions: Roles, Groups & Best Practices
Set up clean, scalable roles and permissions on Paper/Spigot using LuckPerms, with reusable command snippets.
Permissions made easy with LuckPerms: roles, groups, and best practices
LuckPerms is the gold standard for permissions on Paper/Spigot servers. It’s powerful, fast, and well‑documented. This guide gets you from zero to a clean roles setup with commands you can reuse every time you create a new server.
Install
- Download the LuckPerms jar and place it in
plugins/. - Start the server to generate files.
- Optional: Set up the web editor with
/lp editorfor a visual interface.
Core concepts
- Users: Individual players
- Groups: Roles that hold permissions (e.g., default, member, moderator, admin)
- Tracks: Ordered group progressions (e.g.,
member -> vip -> mvp) - Contexts: Conditions (per world, server, time)
Quick start: basic groups
Commands (run in console or as op):
/lp creategroup default
/lp creategroup member
/lp creategroup mod
/lp creategroup admin
/lp default parent add member
# Essentials‑like QoL
/lp group member permission set essentials.home true
/lp group member permission set essentials.sethome true
# Moderation
/lp group mod permission set essentials.kick true
/lp group mod permission set worldguard.region.claim true
# Admin
/lp group admin permission set * true
Replace permissions with those your plugins use. Use plugin docs to find exact nodes.
Assign players
/lp user <name> parent set member
/lp user <name> parent set mod
Web editor
- Run
/lp editorand open the link. - Edit groups and users visually; click “Save” and paste the command back into console.
Tracks (optional)
/lp createtrack rank
/lp track rank append member vip mvp
/lp user <name> parent settrack rank vip
Best practices
- Principle of least privilege: Give only what’s needed.
- Use groups for everything; avoid per‑user overrides unless necessary.
- Keep a text or Markdown doc of your group structure and key nodes.
- Backup LuckPerms data and test changes on a staging server.
Troubleshooting
- A command says “no permission”: Use
/lp verbose onand try the command; check logs to see which node is missing. - Conflicts: Check if a deny node exists in another group. Order and contexts matter.
With a clean group setup in LuckPerms, you’ll spend less time micromanaging permissions and more time playing—and your moderators will know exactly what they can do.