How to Use LuckPerms - Minecraft

What is LuckPerms?

LuckPerms gives you powerful control over player permissions, roles, and server access. It’s one of the most trusted permission plugins, offering a flexible and user-friendly way to manage ranks and commands. Whether you're running a small friends-only server or a large public hub, LuckPerms helps keep everything organized and secure.

In this guide, we'll show you how to use LuckPerms Minecraft in its latest version with simple steps.

With LuckPerms, you can:

Create and manage custom ranks

Set detailed permission nodes for each group

Assign temporary or timed permissions

Use an in-game editor or web interface

Let’s break down how to install, configure, and get the most out of LuckPerms on your server instead of just playing on a default server.

Installing LuckPerms

Make sure to use the compatible server version with the LuckPerms plugin. Check out our guide on how to change your server's version for more information.

To install LuckPerms on a Minecraft server:

Download the LuckPerms Plugin onto your computer.

Open the File Manager and open the plugins folder


Upload the LuckPerms plugin into your plugins folder



Now, start or restart your server for the plugin to work.

Connecting MySQL Database (Optional Step)

If you are handling a large amount of data, we recommend setting up a database for this plugin.

To create a database, click “Databases” on the left-hand side of the Apollo panel.



Click “New Database” on the top right-hand side corner.

Fill out the required database info on-screen, which includes the following:

Database Name

Allowed Connections (Where the connections come from)

Database Location



Once created, copy the database name.



To view the database details, right-click and click on "Details" to view the database details



Head over to the LuckPerms folder and find the config.yml file in the file manager.



Edit the following and replace the values with your values. Remember to change the storage method from h2 to mysql`



In this instance, It would look like this:

Configuring LuckPerms

To configure LuckPerms on your Minecraft server:

In the server console, do the following command. Replace <username> with the administrator username of choice, which will allow server admins to control what features players can use.

lp user <username> permission set luckperms.*

Example Usage: lp user justgreg permission set luckperms.*

This will assign permissions to the user



To create groups, you can do the following command in-game or on the console. Replace <Group Name> with the name of the group

lp creategroup <Group Name>

Example Usage: lp creategroup admin



To add a user to a group, you are able to do the following command in-game or on the console. Replace <username> with the username of choice and <Group Name> with the name of the group

lp user <username> parent set <Group Name>

Example Usage: lp user justgreg parent set admin



To add permissions to a group, you are able to do the following command in-game or on the console. Replace <Group Name> with the name of the group and <Permission> with the permission value

lp group <Group Name> permission set <Permission> true

Example Usage: lp group admin permission set essentials.ban true



To add a prefix to a group, you are able to do the following command in-game or on the console. Replace <Group Name> with the name of the group, <Weight> with the weight, and <Prefix> with the name of the prefix.

lp group <Group Name> meta addprefix <Weight> “<Prefix>”

Example usage: lp group admin meta addprefix 100 “&c[Admin]”

Make sure to include the quotation marks (“) in the prefix! YELLELOW BOX



To edit a prefix to a group, you can do the following command in-game or on the console. Replace <Group Name> with the name of the group and <Weight> with the weight

lp group <Group Name> meta removeprefix <Weight>

Example Usage: lp group admin meta removeprefix 100



Once you have done this, continue to add prefixes to groups as needed.

Still have some questions about setting up LuckPerms?

You can create a ticket here, after creating the ticket, we'll respond right away

Updated on: 03/04/2025