Articles on: Minecraft

How to Install LuckPerms on Your Minecraft Server

How to Install LuckPerms on Your Minecraft Server

LuckPerms is the most advanced and popular permissions plugin for Minecraft servers, offering unparalleled control over player permissions, ranks, and groups. Whether you're managing staff members, creating VIP tiers, or controlling plugin access, LuckPerms provides an intuitive web-based editor and powerful features. With Loafhosts' LoafPanel, installing and configuring LuckPerms is straightforward through our integrated Plugin Manager.

What is LuckPerms?

LuckPerms is a comprehensive permissions management plugin that allows server administrators to control exactly what players can and cannot do. It replaces older, outdated plugins like PermissionsEx and GroupManager with modern features and better performance.

Key Features

  • Web-Based Editor: Visual permission configuration in your browser
  • Group System: Create ranks like default, VIP, moderator, admin
  • Inheritance: Groups can inherit permissions from other groups
  • Temporary Permissions: Grant permissions that expire automatically
  • Context-Based: Different permissions per world, server, or custom context
  • Track System: Promotion and demotion tracks (default → VIP → MVP)
  • Vault Integration: Works with economy and chat plugins
  • Database Support: MySQL, MariaDB, PostgreSQL, MongoDB, or file-based
  • Cross-Server Sync: Share permissions across multiple servers
  • Extensive API: For plugin developers

Why LuckPerms?

Advantages Over Alternatives:

  • Active development and frequent updates
  • Superior performance and optimization
  • User-friendly web editor
  • Comprehensive documentation
  • Large community support
  • No limitations on permissions or groups
  • Better compatibility with modern plugins

Prerequisites

Before installing LuckPerms:

  • Access to your Loafhosts panel at https://panel.loafhosts.com
  • Minecraft server running Spigot, Paper, Purpur, or similar
  • Basic understanding of permission nodes
  • Operator access to your server

Installation via LoafPanel Plugin Manager

The easiest method to install LuckPerms is through the integrated Plugin Manager.

Step 1: Access the Plugin Manager

  1. Log in to your Loafhosts panel at https://panel.loafhosts.com
  2. Select your Minecraft server
  3. Navigate to Management → Plugins
  4. You'll see the Plugin Manager interface


Step 2: Search for LuckPerms

  1. Use the search bar at the top
  2. Type "LuckPerms"
  3. The plugin will appear in search results
  4. You'll see download count and description


Step 3: Select Provider and Version

  1. Click on the Providers dropdown if available
  2. Select SpigotMC (recommended) or Hangar
  3. Click Versions to see available versions
  4. Select the latest version or a specific release


Step 4: Install LuckPerms

  1. Click the blue Install or Download button
  2. The plugin downloads and installs automatically
  3. Wait for confirmation message
  4. The plugin file is placed in /plugins/ folder

Step 5: Restart Your Server

  1. Navigate to General → Console or use the top controls
  2. Click the Restart button
  3. Wait for server to fully restart
  4. LuckPerms will load and generate configuration files

Verifying Installation

Check that LuckPerms installed correctly:

Via Console

  1. Navigate to General → Terminal
  2. Look for LuckPerms startup messages:
[LuckPerms] Loading LuckPerms v5.4.xxx
[LuckPerms] Enabling LuckPerms v5.4.xxx

Via In-Game Commands

  1. Join your server as an operator
  2. Type /luckperms or /lp
  3. You should see the LuckPerms command interface
  4. If you see the help menu, installation was successful!

Via Plugins List

In-game or console, type:

/plugins

LuckPerms should appear in green, indicating it's loaded and running.

Initial Configuration

After installation, configure LuckPerms for your server.

Step 1: Access Configuration File

  1. Navigate to Management → Files
  2. Go to /plugins/LuckPerms/
  3. Open config.yml


Step 2: Basic Configuration Settings

Key settings to review in config.yml:

# Storage method: h2, mysql, mariadb, postgresql, mongodb, sqlite
storage-method: h2

# Server name (useful for multi-server setups)
server: global

# Whether to apply global permissions
include-global: true

# Debug mode (disable after setup)
debug: false

# Web editor URL
web-editor-url: https://luckperms.net/editor/

Default Storage (H2): File-based database, perfect for single servers. No additional configuration needed.

MySQL Storage (for multi-server networks):

storage-method: mysql

data:
  address: localhost:3306
  database: minecraft
  username: root
  password: your_password

Step 3: Save and Reload

  1. Save the configuration file
  2. In-game or console, type:
/lp reload

Or restart the server for changes to take effect.

Setting Up Your First Group

Create a basic permission structure with default and admin groups.

Creating the Default Group

  1. In-game or console, type:
/lp creategroup default
  1. Set the default group's display name:
/lp group default setdisplayname Default
  1. Give basic permissions:
/lp group default permission set minecraft.command.help true
/lp group default permission set essentials.spawn true
/lp group default permission set essentials.tpa true

Creating an Admin Group

  1. Create the admin group:
/lp creategroup admin
  1. Set display name:
/lp group admin setdisplayname Admin
  1. Give admin all permissions:
/lp group admin permission set * true
  1. Make admin inherit default permissions:
/lp group admin parent add default

Setting Default Group

Make "default" the group all players start with:

/lp group default setweight 0
/lp user <username> parent set default

Or set it globally for all new players in config.yml:

default-assignments:
  default: true

The LuckPerms web editor is the easiest way to manage permissions.

Step 1: Open the Web Editor

In-game or console, type:

/lp editor

This generates a unique URL like:

https://luckperms.net/editor/aBcDeF123456

Step 2: Access the Editor

  1. Click the URL provided (if in-game)
  2. Or copy and paste it into your web browser
  3. The web editor opens with all your groups and users loaded


Step 3: Edit Permissions Visually

In the web editor:

Add Permissions:

  1. Select a group or user on the left
  2. Click Add Permission
  3. Type the permission node (e.g., essentials.heal)
  4. Set to true (allow) or false (deny)
  5. Add optional context (world, server)

Create Groups:

  1. Click Create Group at the bottom
  2. Name your group (e.g., "VIP", "Moderator")
  3. Add permissions and inheritances

Set Inheritances:

  1. Select a group
  2. Click Add Parent
  3. Choose which group it should inherit from

Temporary Permissions:

  1. Add a permission normally
  2. Click the clock icon
  3. Set expiration time (e.g., "7d" for 7 days)

Step 4: Save Changes

  1. Click Save in the top right
  2. Copy the command provided
  3. Paste it in-game or console
  4. Changes apply immediately!

Essential LuckPerms Commands

User Management

Add user to group:

/lp user PlayerName parent add GroupName

Remove user from group:

/lp user PlayerName parent remove GroupName

Give user permission:

/lp user PlayerName permission set permission.node true

View user info:

/lp user PlayerName info

Group Management

Create group:

/lp creategroup GroupName

Delete group:

/lp deletegroup GroupName

Set group permission:

/lp group GroupName permission set permission.node true

View group info:

/lp group GroupName info

Inheritance

Add parent group:

/lp group ChildGroup parent add ParentGroup

Remove parent group:

/lp group ChildGroup parent remove ParentGroup

Temporary Permissions

Temporary group (7 days):

/lp user PlayerName parent addtemp VIP 7d

Temporary permission (1 hour):

/lp user PlayerName permission settemp fly.use true 1h

Meta and Prefixes

Set prefix:

/lp group GroupName meta setprefix 100 "&c[Admin] "

Set suffix:

/lp group GroupName meta setsuffix 100 " &7[VIP]"

Set meta value:

/lp group GroupName meta set meta-key meta-value

Utility Commands

Reload configuration:

/lp reload

Open web editor:

/lp editor

View all groups:

/lp listgroups

Search permissions:

/lp search permission.node

Permission Node Examples

Understanding permission nodes is crucial for effective LuckPerms use.

Wildcard Permissions

* - All permissions (dangerous!)
essentials.* - All Essentials permissions
worldedit.* - All WorldEdit permissions

Negation (Denying Permissions)

-permission.node - Explicitly deny a permission

Example: Give all Essentials permissions except /heal:

/lp group VIP permission set essentials.* true
/lp group VIP permission set essentials.heal false

Common Plugin Permissions

EssentialsX:

essentials.spawn - Use /spawn
essentials.home - Use /home
essentials.sethome - Use /sethome
essentials.tpa - Use /tpa
essentials.back - Use /back
essentials.fly - Use /fly

WorldEdit:

worldedit.selection.* - Selection tools
worldedit.clipboard.* - Copy/paste
worldedit.region.* - Region commands
worldedit.history.undo - Use //undo

WorldGuard:

worldguard.region.* - All region commands
worldguard.region.define - Create regions
worldguard.region.claim - Claim regions

Creating a Permission Hierarchy

Set up a proper rank structure:

Example Structure

Default (weight: 0)
  ↓
VIP (weight: 10)
  ↓
MVP (weight: 20)
  ↓
Helper (weight: 30)
  ↓
Moderator (weight: 40)
  ↓
Admin (weight: 50)
  ↓
Owner (weight: 100)

Implementing Weights

Weights determine permission priority:

/lp group default setweight 0
/lp group vip setweight 10
/lp group mvp setweight 20
/lp group helper setweight 30
/lp group moderator setweight 40
/lp group admin setweight 50
/lp group owner setweight 100

Higher weight = higher priority = permissions override lower groups.

Setting Up Inheritance

Each rank inherits from the one below:

/lp group vip parent add default
/lp group mvp parent add vip
/lp group helper parent add mvp
/lp group moderator parent add helper
/lp group admin parent add moderator
/lp group owner parent add admin

Integrating with Chat Plugins

Display ranks and prefixes in chat using LuckPerms with chat formatting plugins.

With EssentialsX Chat

  1. Install EssentialsX and EssentialsXChat
  2. Edit /plugins/EssentialsChat/config.yml:
format: '{DISPLAYNAME}: {MESSAGE}'
  1. Set prefixes in LuckPerms:
/lp group admin meta setprefix 100 "&c[Admin] "
/lp group vip meta setprefix 50 "&6[VIP] "
/lp group default meta setprefix 0 "&7"

With ChatControl

  1. Install ChatControl or ChatControl Pro
  2. Enable LuckPerms integration in ChatControl config
  3. Prefixes from LuckPerms appear automatically

With TAB Plugin

  1. Install TAB plugin
  2. Configure tablist in /plugins/TAB/config.yml
  3. Use PlaceholderAPI placeholders:
%luckperms_prefix%
%luckperms_suffix%
%luckperms_group_name%

Context-Based Permissions

Give different permissions in different worlds or situations.

World-Specific Permissions

Allow flying only in creative world:

/lp group builder permission set essentials.fly true world=creative_world

Server-Specific Permissions

For multi-server networks:

/lp user PlayerName permission set staff.permissions true server=survival

Multiple Contexts

Combine contexts:

/lp group vip permission set some.permission true world=survival server=main

Promotion Tracks

Automate rank progression with tracks.

Creating a Track

/lp createtrack viptrack
/lp track viptrack append default
/lp track viptrack append vip
/lp track viptrack append mvp

Promoting Players

/lp user PlayerName promote viptrack

This moves them up one rank on the track.

Demoting Players

/lp user PlayerName demote viptrack

This moves them down one rank.

Troubleshooting

Commands Not Working

Solution:

  • Verify LuckPerms loaded: /plugins
  • Check console for errors
  • Ensure you have operator status
  • Try /luckperms instead of /lp
  • Reload: /lp reload

Permissions Not Applying

Solution:

  • Check group inheritance is correct
  • Verify permission node spelling (case-sensitive)
  • Check group weights
  • Reload LuckPerms: /lp reload
  • Player may need to relog

Web Editor Not Loading

Solution:

  • Check internet connection
  • Try different browser
  • Generate new editor session: /lp editor
  • Check firewall settings
  • Visit https://luckperms.net/ to verify site is up

Group Prefixes Not Showing

Solution:

  • Install Vault plugin (required)
  • Install chat formatting plugin (EssentialsXChat, ChatControl)
  • Verify prefix is set: /lp group GroupName meta info
  • Check chat plugin configuration
  • Reload all plugins

Database Connection Errors

Solution:

  • Verify MySQL credentials in config.yml
  • Check database exists
  • Ensure database user has permissions
  • Test connection with MySQL client
  • Check firewall rules

Advanced Features

Using MySQL for Multi-Server

Share permissions across multiple servers:

  1. Set up MySQL database
  2. Edit LuckPerms config on all servers:
storage-method: mysql
data:
  address: your-mysql-host:3306
  database: luckperms
  username: luckperms_user
  password: secure_password
  pool-settings:
    maximum-pool-size: 10
  1. Reload LuckPerms on all servers
  2. Permissions sync automatically!

Verbose Mode

Debug permission checks:

/lp verbose on

Perform actions to see what permissions are checked. Then:

/lp verbose paste

Get a web link showing all permission checks.

API for Developers

LuckPerms provides a comprehensive API for custom plugins:

LuckPerms api = LuckPermsProvider.get();
User user = api.getUserManager().getUser(player.getUniqueId());
// Manipulate permissions programmatically

Permission Calculation

See how permissions are calculated:

/lp user PlayerName permission check permission.node

Shows the result and which group provided the permission.

Best Practices

Security

  • Don't give wildcard (*) permissions to regular players
  • Use negation (-permission) to restrict dangerous commands
  • Regularly audit admin permissions
  • Use temporary permissions for testing
  • Keep ownership permissions separate

Organization

  • Use clear, consistent group names
  • Document your permission structure
  • Use inheritance to reduce redundancy
  • Set appropriate weights
  • Regular backup of permissions

Performance

  • Use H2 (file) storage for single servers
  • Use MySQL for networks
  • Avoid excessive permission nodes
  • Use inheritance instead of duplicating permissions
  • Optimize group structure

Maintenance

  • Regularly update LuckPerms
  • Review and clean unused groups
  • Audit temporary permissions
  • Export backups regularly: /lp export
  • Test permission changes on test server first

Backup and Export

Export Permissions

Create a backup of all permissions:

/lp export filename

This creates a file in /plugins/LuckPerms/ with all permissions, groups, and users.

Import Permissions

Restore from backup:

/lp import filename

Automated Backups

LuckPerms automatically saves backups in /plugins/LuckPerms/backups/

Migration from Other Plugins

From PermissionsEx

/lp migration permissionsex

From GroupManager

/lp migration groupmanager

From bPermissions

/lp migration bpermissions

LuckPerms automatically converts groups, users, and permissions.

Common Permission Sets

Default Player

essentials.spawn
essentials.help
essentials.motd
essentials.rules
essentials.tpa
essentials.tpahere
essentials.home
essentials.sethome
essentials.back

VIP Player

Inherits Default +

essentials.fly
essentials.kit.vip
essentials.nick
essentials.hat
worldedit.selection.pos
coloredchat.chat.color

Moderator

Inherits VIP +

essentials.kick
essentials.mute
essentials.ban
essentials.warn
essentials.tp
coreprotect.inspect
coreprotect.rollback

Admin

Inherits Moderator +

essentials.*
worldedit.*
worldguard.region.*
luckperms.user.*
luckperms.group.*

Need Help?

If you have questions about LuckPerms installation or configuration:

With Loafhosts' LoafPanel and LuckPerms, you have complete control over your server's permission system. Create sophisticated rank structures, manage staff permissions, and build the perfect player progression system with ease!

Updated on: 10/11/2025

Was this article helpful?

Share your feedback

Cancel

Thank you!