RealisticNode Docs

Set Up Ranks & Permissions (LuckPerms)

Create ranks like VIP and Admin on your Minecraft server with LuckPerms. Add permissions, prefixes, inheritance and use the web editor on RealisticNode.

LuckPerms decides what each player is allowed to do. You put players into groups (ranks) like default, vip and admin, and give each group the permissions it needs. It's the most used permissions plugin and works with almost every other plugin.

Plugin servers only

LuckPerms works on Paper, Purpur, Spigot, Folia and Velocity. There are also versions for Fabric, Forge and NeoForge if you run a modded server.

Install LuckPerms

Install the plugin

Open Plugins, search for LuckPerms and install it. See Install plugins.

Restart the server

Restart and check the Console: you'll see LuckPerms load. A group called default is created automatically, and every player is in it.

Give yourself full access

In the Console, type (without the /):

lp user YourName permission set * true

Now you can use every LuckPerms command in game with /lp.

* means every permission of every plugin. Only give it to yourself or the server owners, never to a normal rank.

Create your ranks

A common setup is three groups: default (everyone), vip and admin. Run these commands in the Console:

lp creategroup vip
lp creategroup admin
lp group vip parent add default
lp group admin parent add vip

The parent add lines set up inheritance: vip gets everything default has, and admin gets everything vip has. This way you never have to copy permissions between ranks.

To make sure LuckPerms knows which rank is "higher", give them a weight (higher number = more important):

lp group vip setweight 10
lp group admin setweight 100

Add permissions

Each plugin lists its permissions on its download page or wiki. Add them with permission set:

lp group default permission set essentials.home true
lp group vip permission set essentials.fly true
lp group admin permission set worldedit.* true
  • Use false instead of true to deny a permission (for example to take something away from a rank that inherits it).
  • permission unset removes a permission you added.
  • Not sure which permission a command uses? Type lp verbose on, use the command in game, then lp verbose off. LuckPerms shows every permission that was checked.

Assign players to a rank

CommandWhat it does
lp user Steve parent add vipAdds the vip rank (Steve keeps his other groups).
lp user Steve parent set vipMakes vip Steve's only rank.
lp user Steve parent remove vipRemoves the rank.
lp user Steve parent addtemp vip 30dGives vip for 30 days, then removes it automatically.
lp user Steve infoShows Steve's ranks and prefix.

Prefixes and suffixes

A prefix is the tag shown before a player's name in chat, like [VIP] Steve. Set it on the group:

lp group vip meta setprefix 10 "&a[VIP] "
lp group admin meta setprefix 100 "&c[Admin] "

The number is the priority: if a player has several prefixes, the highest one is shown. &a, &c... are color codes. Use meta setsuffix the same way for text after the name.

Prefixes need a chat plugin

LuckPerms only stores prefixes. To show them in chat, install Vault plus a chat plugin such as EssentialsX Chat (see EssentialsX) or LPC. Restart after installing.

The web editor

Typing commands gets slow with many ranks. The web editor lets you change everything in your browser:

  1. In the Console (or in game), type lp editor.
  2. Open the link LuckPerms gives you.
  3. Add or remove groups, permissions, prefixes and players.
  4. Click Save. The editor shows a command like lp applyedits AbC123.
  5. Paste that command into the Console to apply your changes.

Tracks (promotion ladders)

A track is an ordered list of ranks, useful for staff or ranks players climb over time:

lp createtrack staff
lp track staff append helper
lp track staff append moderator
lp track staff append admin
lp user Steve promote staff

promote moves Steve up one step on the track, demote moves him down.

Store data in MySQL

By default LuckPerms saves its data in a local file (H2), which is fine for a single server. If you run several servers (for example behind Velocity) and want them to share ranks, use a database. Follow MySQL Databases, which includes a LuckPerms example.

On a Velocity proxy, the commands start with lpv instead of lp.

Troubleshooting

On this page