LuckPerms – Part 2: Installation and Setup

Install a Plugin Manager (If You Don’t Have One Yet)

To use permissions plugins like LuckPerms (or any plugin) in Minecraft, you first need to install a plugin manager on your server. LuckPerms comes in versions for both Spigot and Sponge.

• Spigot: Used for servers with plugins only, no mods. LuckPerms for Spigot works with Minecraft versions from 1.7 up to the latest.

• Sponge: Comes in two flavors: Sponge Vanilla for plugin-only servers, and Sponge Forge, which works with Forge and Forge mods. LuckPerms for Sponge Forge supports Minecraft versions 1.10.2 to 1.12.2.

Depending on the plugin manager, your server may require more RAM to handle additional processes, which could increase operational costs.

Installing LuckPerms

Installation is simple: just upload the plugin file to your server’s /plugins or /mods folder depending on your plugin manager.

• Spigot or Sponge Vanilla: /plugins

• Sponge Forge: /mods

Before using the plugin, it still needs to be configured. See the next sections for the effects and setup of installing a permissions plugin.

Immediate Effects of Adding LuckPerms

As covered in Part 1, adding a permissions plugin immediately locks all commands and abilities on your server.

• Default response to any command attempt is “NO!”

• The plugin only grants access when it verifies the command against a list of users, groups, and allowed commands.

If this list hasn’t been created yet, all commands—including those of the server owner—are blocked.

Be aware that until the permissions list is set up, no commands will be available. If the configuration file or database is deleted later, all access will be blocked again.

Configuring LuckPerms

Choose a Storage Method

After installing LuckPerms, the first step is choosing how the permissions data will be stored. Plugins need a way to save groups, users, and allowed commands. This can be done via editable text files or databases.

LuckPerms supports multiple options:

• Plain text files

• H2 or SQLite

• Full databases like MySQL

It even supports database conversion and distributed setups. For more details: LuckPerms GitHub – Storing Data

On HolyHosting Minecraft servers, you can create a free MySQL database that runs in parallel with your server. MySQL is powerful, fast, and essential for setups like Bungeecord, where multiple servers share data.

Create a MySQL Database

1. Open your HolyHosting control panel.

2. Click MySQL Database in the sidebar.

3. Click Create Database (green button).

The database is created in seconds. Your panel will show the database name, username, password, and host info.

HolyHosting handles all backend details automatically—you just click a button!

Edit LuckPerms Configuration

1. Locate the LuckPerms.cfg file in the config/luckperms folder.

2. Edit the file in your file manager.

3. Lines with # are comments and ignored by the server.

4. URLs in the comments link to detailed documentation on LuckPerms features.

Set the Storage Method

• Go to line #85 and replace "H2" with "mysql" (or another method if you prefer).

Set MySQL Host and Port

• Line #97: Replace "localhost" with the MySQL Database Hostname from your panel, followed by a colon : and the port number (default 3306).

Set Database Name

• Line #101: Replace "minecraft" with the Database Name from your panel.

Set Database Username and Password

• Lines #104–105: Replace "root" with the Database Username and the password in the quotes next to it.

Most other configuration options are advanced settings you likely won’t need to change right now.

Save the changes, and your MySQL database is now configured and ready for LuckPerms.

Accessing the Database

1. Via HolyHosting Control Panel:

   • Go to MySQL Database, click PHPMyAdmin, and log in with the database credentials.

     
     

2. Via LuckPerms In-Game Editor:

   • Run /lp editor in your server console or in-game.

   • A URL will appear—open it in your browser to access the web-based LuckPerms editor.

Now you’re fully connected to your MySQL database and can manage groups, players, and permissions easily.

Conclusion

We hope this guide has been helpful! 🚀 Remember, don’t hesitate to ask questions on the HolyHosting Discord or contact our support team.

Follow us on Twitter @HolyHosting to stay up to date.

Stuffy @ HolyHosting