Skip to content
AleForge Documentation

How to Install and Configure LuckPerms on your Minecraft Server

Why install LuckPerms?

If you’re looking for a robust and reliable way to manage permissions in Minecraft, LuckPerms is an excellent choice. It’s easy to install and configure; this guide will take you through the process. Remember that our configurations are just the basics, so feel free to customize them to suit your needs.

How to Install LuckPerms

  1. Go to the AleForge Panel
  2. Go to the Console page and stop your server
  3. Open the Versions page to verify you have Spigot or Paper installed
  4. Next, open the Plugins Installer page
  5. Search for LuckPerms

  1. Click Install next to luckPerms
  2. Open the Console page and start your server

Connect LuckPerms to MySQL

  1. Click Databases from the left-hand navigation menu
  2. Select New Database
  3. Input a Database name in the Database Name field

  1. Click Create Database
  2. Once the database is created, copy the following:

Endpoint

Database Name

Username

Password

Click the Eye icon next to the trashcan to show the password.

  1. Open the File Manager
  2. Navigate to /plugins/LuckPerms
  3. Open config.yml
  4. Change the following to enable MySQL support

- storage-method : MySql

- address:Endpoint from step 5

- database: Database Name from step 5

- username: Username from step 5

- Password: Password from step 5

  1. Click Save Content in the top right
  2. Open the Console page and restart your server

Configuring the Permissions in LuckPerms

You are required to be a server operator to change permissions

  1. Open Minecraft and connect to your server
  2. Run /luckperms editor
  3. Click on the link that appears in chat and select Yes

  1. The first time you connect to the LuckPerms editor from a browser you’ll have to copy and paste a command in game to authenticate your web browser

  1. Let’s create an admin group. Pres the plus icon next to Groups to begin making a group

  1. Here is what each of these terms mean
    1. Group name
      1. The official name of the group, this is usually used when referencing the group using any in-game commands
    2. Display name
      1. This is what will show up in the LuckPerms editor. This is not how the group will appear in game
    3. Parent
      1. Which group, if any, the group you are creating will inherit. If this is set the group will have all permissions from the “parent” group it is inheriting from
    4. Weight
      1. In the case of a player having multiple groups assigned to them, the group with a higher weight will take priority
    5. Prefix (Requires the plugin “Vault”)
      1. The tag that will be displayed before the players username in game
    6. Suffix (Requires the plugin “Vault”)
      1. The tag that will be displayed after the players username in-game

  1. After you have created the Admin group, you can start adding permissions. The permissions you are able to add are dependent on what plugins you have installed. The most commonly used plugin is EssentialsX and a list of all of the permission nodes in it can be found here. In this example, we want to give our admin group access to everything so we’ll add * under permissions.

  1. Next we’ll want to assign the Admin group to our user. This can be done by selecting the user from Users and adding the permission node group.groupname

  1. Press Save at the top of the page. It will show a pop-up with a command inside. Copy the command

  1. Go back into Minecraft and run the command. This will apply your changes to the permissions

Get Your Own Server

Want a server with no performance comprises that meets all budgets? Then check out AleForge’s Minecraft hosting, where we never oversell our hardware and put even our budget-conscious customers on high-performing hardware. Locations are available worldwide with the lowest latency possible.