How to configure LuckPerms on a Minecraft server

LuckPerms is the most widely used permissions plugin on Minecraft servers. It saves you from giving OP to everyone, without holding your players back. This guide shows how to install LuckPerms with OuiPanel, the game panel, and how its groups and inheritance work. You will then create an admin group and a player group from the web editor.

---

Why LuckPerms?

On a Minecraft server, permissions decide what each player can do, from the commands they type to the places they reach. Without a permissions system, you are stuck between two extremes. Either everyone is limited, or you hand out OP and lose all control.

With LuckPerms, you create groups (player, moderator, admin and so on), give them precise permissions, and each player inherits the rights of their group. It suits a small survival server for friends as well as a large community project.

LuckPerms comes as a plugin (Paper, Spigot, Bukkit and others) and as a mod (Forge, NeoForge, Fabric and others). It works on almost every kind of server.

---

Install LuckPerms

As a plugin (Paper, Spigot, Bukkit)

The OuiPanel Plugins page installs LuckPerms for you.

1. In the side menu, open Plugins, Catalog tab.

2. Type LuckPerms and click Search.

3. On the LuckPerms card, click Install, then confirm with Install.

4. Restart the server.

You can also download the .jar file from the official LuckPerms site, then drag it into the plugins folder of the File Manager. No FTP needed. How to install plugins on your Minecraft server covers both methods.

As a mod (Forge, NeoForge, Fabric)

Same idea, but the .jar file goes in the mods folder. On the LuckPerms site, pick the build that matches your mod loader to avoid startup errors.

LuckPerms works almost the same way as a plugin or a mod. Commands and the web editor are identical, only the install folder changes.

LuckPerms can also run on a proxy (Velocity, BungeeCord). That is a more advanced setup, described below.

Check the installation

After the restart, open Console. If the install went well, you see a line like this one.

[LuckPerms] Successfully enabled.

From now on, leave OP aside. Rights are managed through LuckPerms.

---

Understand groups, inheritance and the editor

Permission groups

With LuckPerms, you do not manage permissions player by player. You create groups, and each player inherits the permissions of their group. By default, LuckPerms creates a default group that applies to everyone. You then add the groups you need, such as player, moderator or admin.

Inheritance between groups

A group can inherit from another. Your moderator group can inherit from the player group and only add moderation permissions. If you change a permission in the base group, every group that inherits from it follows, with nothing to copy.

The web editor

The LuckPerms online editor replaces dozens of commands with a web interface. To open it, type this command in game, or lp editor without a slash in Console.

/lp editor

LuckPerms shows a link and a code. Open the link in your browser and enter the code. The editor then shows your groups and permissions.

Keep the editor tab open while you configure. You will apply all your changes at once at the end.

In-game commands are still handy for a quick tweak without opening the browser, but the editor is clearer for organizing groups.

---

Create an admin group

This group has every right on the server. Keep it for yourself and the admins you trust.

Create the group

In the web editor, click the + button in the Groups column, then fill in the fields.

Field	Value
Group name	admin, the internal name
Display name	Administrator, the readable name
Parent	empty, or a base group
Weight	priority over other groups, the higher it is, the more the group wins

Click Add group. The admin group is created.

Give it every permission

Select the admin group, then type the character below in the permission field.

*

This is a wildcard. It stands for every permission on the server, from Minecraft, your plugins and the server software.

Click Add, then Apply at the top right to save. Green lines turn grey once the changes are applied on the server.

The * permission grants full access. Only give it to people you trust completely.

Assign the group to a player

The player must have joined the server at least once, so LuckPerms knows their account. Then type this command, replacing <username> with their Minecraft name.

/lp user <username> group add admin

The console confirms the change.

Limit how many admins have the * permission. The more there are, the higher the risk of mistakes.

Should you remove OP once LuckPerms is set up? Yes, it is recommended. OP grants full access with no fine control, while an admin group can be managed and removed cleanly.

---

Create a player group with useful commands

This group is for your players day to day. The example assumes a survival server with the EssentialsX plugin. The goal is to allow /sethome, /home and teleport requests without handing over the keys to the server.

Create the group

In the LuckPerms editor (/lp editor if needed), create a group named player.

Add home permissions

Select the player group and add these permissions.

• essentials.sethome

• essentials.home

Your players can now set a home and teleport to it.

Add teleport permissions

For teleports between players, add at least these permissions.

• essentials.tpa

• essentials.tpaccept

• essentials.tpdeny

• essentials.tpacancel

Your players can then send a teleport request, accept it, deny it or cancel it.

Almost every plugin lists its permissions on its official page or in its documentation. For EssentialsX, the full list is in its permissions documentation. Sort your permissions by theme (homes, teleports, moderation and so on) to keep things tidy.

Apply and assign

Click Apply in the editor, then add your players to the group.

/lp user <username> group add player

Players in this group can use /sethome, /home, /tpa, /tpaccept, /tpdeny and /tpacancel, without OP.

---

Share permissions across several servers

LuckPerms can be installed on a BungeeCord or Velocity proxy to centralize permissions for several servers. The servers then share a MySQL database. To start with, install LuckPerms directly on your server.

1. Create a database in Databases with Create database. How to create and manage a MySQL database on OuiPanel shows how to get its connection details.

2. In the File Manager, open plugins/LuckPerms/config.yml.

3. Switch storage to MySQL and fill in the database, then click Save.

storage-method: MySQL

data:
  address: database-host:3306
  database: s12345_luckperms
  username: u12345_example
  password: 'your-password'

Do the same on every server that should share permissions, then restart them.

---

Need help?

Open a ticket from Tickets › Open a Ticket, or from the Contact support tile at the bottom of your server's page in the client area. You can also ask your question on the OuiHeberg Discord.

Open a ticketDiscord