How to Install LuckPerms on a Minecraft Server

LuckPerms is the standard permissions plugin for Minecraft. It lets you create ranks, assign permissions, and control who can use commands — without editing every plugin's config by hand.

It supports Paper, Spigot, Bukkit, Fabric, Velocity, and BungeeCord. This guide covers installing it on a Beacon Hosting server.

Which folder to use

| Server software | LuckPerms build | Folder | | --- | --- | --- | | Paper, Spigot, Bukkit, Purpur | Bukkit | plugins | | Fabric | Fabric | mods | | Velocity | Velocity | plugins on the proxy | | BungeeCord / Waterfall | Bungee | plugins on the proxy |

Check your software on the server Startup page if you are unsure.

Velocity and BungeeCord are proxies, not game servers. Install the proxy build on the proxy, and a Bukkit/Fabric build on each backend server.

Method 1: Package Manager (recommended)

1. Open your server from Server Selection.
2. In the sidebar, open Package Manager.
3. Search for LuckPerms.
4. Open the listing that matches your software (Bukkit for Paper/Spigot, Fabric for Fabric, and so on).
5. Click Install.
6. Restart the server from Console when the install finishes.

Then skip to Verify the install.

Method 2: Upload the JAR yourself

Use this if LuckPerms is not in Package Manager, or you need a specific build.

1. Download LuckPerms

Download from the official site only: luckperms.net/download.

Pick the build for your software. Do not use a random JAR from a third-party site.

2. Stop the server

On the Console page, stop the server before you replace plugin or mod files.

3. Upload the file

Open Files in the sidebar.

• Paper / Spigot / Bukkit: go to plugins and click Upload.
• Fabric: go to mods and click Upload.

You should end up with a .jar in that folder — for example plugins/LuckPerms-Bukkit.jar. Do not nest it inside another folder.

4. Start the server

Start the server from Console. Watch the log for LuckPerms loading without errors.

Verify the install

Run this in the Beacon Console (no slash required):

lp

If LuckPerms loaded, it prints command help. Then run:

lp info

to confirm the version and storage type.

Give yourself admin access

From the Console, replace PlayerName with your Minecraft username:

lp user PlayerName permission set luckperms.* true

Or make a staff group and add yourself:

lp creategroup admin
lp group admin permission set luckperms.* true
lp user PlayerName parent add admin

Use parent add so you do not wipe other groups the player already has. parent set replaces them.

Join the server and run /lp. You should now see LuckPerms help in-game.

The easiest way to edit ranks after that is the web editor:

lp editor

That prints a URL. Open it, make changes, then click save — LuckPerms applies them to the server.

Create a rank

From Console or in-game (once you have luckperms.*):

lp creategroup vip
lp group vip permission set example.permission true
lp user PlayerName parent add vip

Replace example.permission with a real node from the plugin you are configuring (for example an EssentialsX or WorldEdit permission). LuckPerms only stores and checks nodes — it does not invent them.

Inspect a player with:

lp user PlayerName info

Networks and databases

A single Paper or Fabric server can keep using LuckPerms' default file storage. You do not need MySQL for that.

For a Velocity or BungeeCord network, point every LuckPerms instance at the same database so ranks follow players between Lobby, Survival, and other servers. LuckPerms supports MySQL, MariaDB, and PostgreSQL.

Configure that in LuckPerms/config.yml after the first start. Restart (or run lp reload config) after changing storage.

Troubleshooting

lp does nothing in Console

• Confirm the JAR is in plugins (Paper family) or mods (Fabric).
• Confirm you installed the matching build.
• Scroll the startup log for a LuckPerms error or UnsupportedClassVersion.

/lp works in Console but not in-game

You are not OP and do not have luckperms.* yet. Run the grant command in Console, then rejoin.

LuckPerms does not show in the plugin list

Paper/Spigot only lists Bukkit plugins in plugins. A Fabric JAR in mods will not appear there. Check the startup log instead.

A permission does not apply

1. Confirm the node is spelled exactly as the other plugin documents it.
2. Run lp user PlayerName info and check the player's groups.
3. Look for a more specific deny (false) that overrides the allow.
4. Confirm the other plugin is actually installed and loaded.

Summary

• Paper / Spigot: Bukkit build → plugins
• Fabric: Fabric build → mods
• Install: Package Manager, or upload the official JAR
• First commands: Beacon Console, then lp user PlayerName permission set luckperms.* true