Skip to main content

Requirements

Before installing the LuckPerms Configuration, ensure you have the following:
LuckPerms
Required
required
Download and install LuckPerms from the official website.
Chat Plugin
Required
required
Install a chat plugin to display rank prefixes and suffixes. Popular options include:
  • EssentialsChat
  • ChatControl
  • LitChat
  • DiscordSRV
  • Any chat formatting plugin
Java 8+
Required
required
Ensure your server is running Java 8 or higher for compatibility.

Installation Steps

1

Prepare Server

Ensure LuckPerms and a chat plugin are installed and enabled on your server.
2

Extract Files

Download and extract the LuckPerms.zip file to your computer.
3

Select Style

Choose one of the 3 available styles:
  • Style 1 - SmallCaps: Modern small-caps styling
  • Style 2 - DefaultFont: Clean default font
  • Style 3 - DefaultBracket: Professional bracket format
4

Upload Configuration File

Copy the selected .json.gz file to your server’s LuckPerms folder (usually plugins/LuckPerms/).
5

Import Configuration

Execute one of these commands in your server console or as an admin in-game:
/lp import Style1-SmallCaps
or
/lp import Style2-DefaultFont
or
/lp import Style3-DefaultBracket
6

Verify Import

Check that the import was successful. You should see a confirmation message in the console.
7

Restart Server

Restart your server to fully apply all changes.
8

Test Ranks

Give a player a test rank using /lp user <name> parent add <rank> and verify the prefix displays.

After Installation

The configuration will be loaded successfully and ready to use immediately after import!
Available Ranks Include:
  • Staff ranks (Owner, Admin, Moderator, Helper)
  • Donator ranks (Diamond, Platinum, Gold, Silver, Bronze)
  • Achievement ranks
  • 40 total groups with full permissions
All ranks are pre-configured with appropriate permissions. You can modify permissions per rank using the LuckPerms commands or web editor at http://localhost:8080 (default).

Need Help?

If you encounter any issues during installation, check the FAQs or reach out to support on our Discord.