MinecraftMinecraft LuckPerms is a reliable permissions plugin, but a handful of issues come up often enough to be worth a dedicated troubleshooting guide. Check your console for errors first: most of these problems leave a clue there.
Permissions Aren't Working
- Make sure LuckPerms is the only permission plugin installed. Running a second one alongside it, such as PermissionsEx, stops LuckPerms from being used for permission checks at all. The one exception is during a migration, where both need to be installed briefly before you remove the old one.
- Double check you're using the exact permission node another plugin expects. Check that plugin's own documentation rather than guessing.
- If you can't find the right node, run
/lp verbose record <player>before the player tries the action, then read the recorded checks to see exactly what was tested. - On Fabric servers, vanilla commands aren't permission gated by default, since Fabric doesn't hook into them the way Bukkit and Sponge do. A mod like Command Hider closes that gap.
Syncing Permissions Across Multiple Servers
Running LuckPerms across a proxy network needs a bit more setup than a single server.
- Install LuckPerms on every backend server plus your BungeeCord or Velocity proxy, and point all of them at the same remote database, such as MySQL or MariaDB.
- Turn on IP forwarding on the proxy, and set
bungeecord: truein each backend server'sspigot.yml. - Set
messaging-servicetosqlin the LuckPerms config on every server so a change made on one pushes out to the rest automatically.
Prefixes or Suffixes Aren't Showing
LuckPerms prefix not showing is one of the most common issues reported, and it usually comes down to one of these causes.
- LuckPerms stores prefix and suffix data but never displays it itself. You need a separate Vault compatible chat plugin to actually show it in chat or the tab list.
- Confirm the value is set correctly by running
/lp user <name> infoand checking the prefix or suffix listed there. - If you're using Essentials, make sure it's the EssentialsX build with EssentialsXChat installed. Older, non-X versions of Essentials don't read data through Vault correctly.
- If a prefix or suffix is showing, but the wrong one, mismatched weights are the usual cause. Give each one a distinct weight instead of leaving them all at zero.
Other Common Issues
- Losing all permissions after installing on SpongeForge: This is expected behaviour. SpongeForge disables its OP system the moment any permission plugin is installed. Grant the missing permissions to your groups directly to fix it.
- Server shuts down after installing LuckPerms: LuckPerms itself never shuts a server down. If you also run AuthMe, check the console. AuthMe stops the server by default when it can't hook into a permissions plugin, and setting
forceVaultHooktotruein AuthMe's config resolves it.
Still stuck? The LuckPerms wiki keeps a fuller FAQ, and their Discord is the best place to ask if your issue isn't listed here. Alternatively, you can open a ticket with us, and our team would be happy to help.
The most common Minecraft LuckPerms issues are sorted, and you know where to look if a new one comes up.
