Setting up ranks on your Minecraft server helps keep things organized, rewards player progress, and adds a personal touch to your server. In this guide, we will use LuckPerms along with some additional plugins or mods, since LuckPerms does not handle chat formatting on its own.
LuckPerms lets you create groups with specific permissions, assign players to these groups, and control what commands or features each group can access. It is perfect for managing roles like moderators, VIPs, or new players.
This step-by-step guide will show you how to set up your rank system and includes helpful tips to make the process easier. It assumes LuckPerms is already installed on your server. If you haven’t installed it yet, please check out our Help Article to get started.
Getting Started
To ensure chat formatting shows correctly in-game, you’ll need to install extra plugins or mods along with LuckPerms, as LuckPerms does not manage chat formatting itself. Below is a recommended list for different server types. Be sure to use versions that match your server setup.
💡Heads up: Please note that these recommendations are based on common use and functionality. You’re welcome to explore other plugins or mods that offer similar features and choose what works best for your needs.
Server Type | Plugin/Mod Name |
Notes |
Paper/Purpur/Bukkit |
Required for chat formatting and economy integration with LuckPerms. Note: For EssentialsX & EssentialsX Chat, download the latest stable releases. |
|
Fabric | Enables LuckPerms chat prefixes and player list formatting. | |
Forge/NeoForge | Designed to support LuckPerms prefixes and chat formatting on Forge. |
Creating Permissions Groups
Permission groups simplify player management by letting you assign a set of permissions to multiple players based on their role. Instead of setting permissions for each player individually, you can organize them into groups. This keeps your server organized and ensures players have the correct access. You can also set a default group for new players, automatically assigning them specific permissions when they join.
For example:
- Create a "Subscriber" group. This role can be assigned to players who subscribe to your YouTube or Twitch channels.
- Set up "Staff" or "Admin" groups with special permissions for moderation or server management.
Creating a Group
💡Tip: If you're looking to edit the default groups settings, find more information on how to do that here!
1. Open the Web Editor and click the + next to the Group dropdown on the left toolbar.
2. Enter the following information:
Section | Description | Example |
Group Name | The internal name of the group in LuckPerms. | "support" or "vip" |
Weight | Determines group priority. Higher weights override lower ones. For best results, leave large gaps between groups | 100, 200, 300 |
Display Name | The name shown for the group in the LuckPerms Web Editor toolbar. | "Support Staff" or "VIP" |
Prefix |
Text shown in-game before the player’s name. Add a space at the end of your prefix to make sure it displays correctly in-game. |
[Support] [VIP] |
Assign a Parent | Sets a parent group to inherit permissions from. Useful for layered permissions. | default or none |
Suffix (optional) | Text automatically added after a player’s username in chat. | "The Almighty" |
- When setting up your prefix, you can use various codes for colors and formatting.
- For example, the prefix "&6&l[Support]&f " appears as [Support] in-game.
- &6 - sets the color to gold
- &l - makes the text bold
- [Support] - is the prefix text shown in-game
- &f - resets the color to white for any text that follows
- For example, the prefix "&6&l[Support]&f " appears as [Support] in-game.
For color and formatting options, see the list below.
Color Reference | Formatting Reference |
0 - Black | k - Obfuscated/MTS (Magical Text Source.) |
1 - Dark Blue | l - Bold |
2 - Dark Green | m - |
3 - Dark Aqua | n - Underline |
4 - Dark Red | o - Italic |
5 - Dark Purple | r - Reset |
6 - Gold |
|
7 - Gray | |
8 - Dark Gray | |
9 - Blue | |
a - Green | |
b - Aqua | |
c - Red | |
d - Light Purple | |
e - Yellow | |
f - White |
4. Once you've set up the group, click the "Add Group" button at the bottom. This will take you to your groups screen in the LuckPerms Web Editor, save and apply your changes.
Assigning a Player to a Group
🗒Note: By default, all players are placed in the "default" group. While you can remove players from this group, it cannot be deleted. To manage its permissions, click on "default" in the Groups tab, then add or restrict permissions as needed.
1. In the Web Editor, click the Users tab on the left to expand it.
2. Under Web Permissions Editor, click the green + next to Parent Groups.
3. Select the group from the dropdown, click Save at the top right, and run the given command in-game.
4. Confirm everything is working properly by entering the game and typing in the chat. If successful, you will see the changes you made appear!
If things are not displaying correctly, please check the following:
- LuckPerms and any required plugins or mods are installed.
- The group is configured properly in LuckPerms, with no spelling or formatting errors.
- The player is assigned to the correct group.
- All changes have been saved.
- For Neoforge, Forge, or Fabric users, make sure any extra settings in the mod or LuckPerms config files are set up.
If problems persist, try starting over to confirm that everything is installed and configured properly.
For more in depth Group configuration details, visit the LuckPerms Wiki.
If you need help, don't hesitate to reach out to our support team by submitting a Support Ticket or contacting us directly via LiveChat!