Skip to main content

​
Setup Guide

To setup the LuckPerms configuration, follow the given instructions:
1

Verify Requirements

Ensure you have LuckPerms and a chat plugin installed on your server.
2

Extract Configuration

Extract the LuckPerms.zip file and open the folder to see the 3 style options.
3

Choose Configuration File

Select one of the 3 .json.gz files:
  • Style1-SmallCaps.json.gz - Modern small-caps styling
  • Style2-DefaultFont.json.gz - Clean default font
  • Style3-DefaultBracket.json.gz - Professional bracket formatting
4

Upload to Server

Paste your chosen .json.gz file into the LuckPerms folder in your server’s plugins directory.
5

Import Configuration

Use one of the following commands in console or in-game:
  • /lp import Style1-SmallCaps
  • /lp import Style2-DefaultFont
  • /lp import Style3-DefaultBracket
6

Verify Installation

Check the console for a success message confirming the import completed.
7

Test Ranks

Give yourself or another player a rank and verify the prefix displays correctly.
The config will be loaded successfully and ready to use after import!

​
Switching Styles

If you want to switch to a different style:
  1. Keep a backup of your current style
  2. Delete the imported data (or backup first)
  3. Import the new style using the appropriate command
  4. Restart the server
All rank data will be replaced with the new style’s configuration.
You can customize individual rank permissions:
  • Use /lp group <group> permission set <permission> true/false
  • Or use the web editor via /lp editor
  • All changes take effect immediately
Refer to the LuckPerms documentation for advanced permission setup.
To create additional ranks beyond the 40 included:
  1. Use /lp group create <group_name>
  2. Set permissions with /lp group <group> permission set <permission> true/false
  3. Set display name with /lp group <group> setdisplayname <name>
  4. Set weight for ordering with /lp group <group> setweight <weight>
The configuration includes proper inheritance setup:
  • Staff ranks inherit from lower staff positions
  • Donator ranks are independent
  • Achievement ranks add bonuses without replacing base ranks
  • Use /lp group <group> parent add <parent> to add inheritance
Rank prefixes and suffixes display through your chat plugin:
  • Ensure your chat plugin is configured to use LuckPerms placeholders
  • Common placeholders: %luckperms_prefix%, %luckperms_suffix%, %player_name%
  • Refer to your chat plugin’s documentation for placeholder setup

​
Common Topics

Questions about installing LuckPerms, uploading configuration files, and initial setup.
Help choosing between the 3 different style options and how to change styles.
How to assign ranks, create new ranks, and manage rank permissions.
Understanding and configuring rank inheritance relationships.
Ensuring compatibility with chat plugins and other server plugins.

​
Need Help?

If you encounter any issues or have questions that aren’t covered here, please reach out to support on our Discord. We’re here to help!