Setting up auto-expiring prefixes and prefix filtering for your Minecraft server using EssentialsX, LuckPerms, and Vault. These plugins provide a robust system for managing player ranks, temporary prefixes, and customized chat formats, enhancing the chat experience for server communities.
Prerequisites
Before you begin, ensure you have a Minecraft server with the following plugins installed:
- EssentialsX – A core plugin that handles many commands and functions for Minecraft servers.
- LuckPerms – A powerful permissions plugin that allows for temporary ranks and prefixes.
- Vault – A dependency plugin that enables EssentialsX to work with LuckPerms for prefixes and suffixes.
Step 1: Setting Up LuckPerms for Auto-Expiring Prefixes
LuckPerms allows you to assign temporary permissions and prefixes to players. Here’s how to configure auto-expiring prefixes:
1. Install LuckPerms
- Download the latest version of LuckPerms from the official LuckPerms website.
- Place the LuckPerms
.jar
file in theplugins
folder of your Minecraft server. - Restart your server to load LuckPerms.
2. Assigning Temporary Prefixes
With LuckPerms installed, you can assign temporary prefixes to players using commands.
Command Syntax:
- username: The player’s in-game username.
- weight: The priority of the prefix (higher numbers will appear first if a player has multiple prefixes).
- prefix: The prefix text (e.g.,
[VIP]
). - duration: The amount of time the prefix should last (e.g.,
1d
for one day,1h
for one hour).
Example: To assign a temporary [VIP]
prefix to the player Alex
for 7 days:
3. Confirm Prefix Expiration
To verify that the prefix will expire correctly, you can check a user’s prefix settings:
This command displays information about the user, including any temporary permissions or prefixes with expiration dates.
Step 2: Configuring EssentialsX for Prefix Display
To display prefixes from LuckPerms in chat, configure EssentialsX’s settings.
1. Modify EssentialsX Config
- Open the
config.yml
file in the EssentialsX folder. - Find the section titled
displayname
. Setchange-displayname
totrue
. - In the same section, set
add-prefix-suffix
totrue
to enable prefix and suffix display from LuckPerms.
Your configuration should look like this:
- Save the changes and restart your server.
2. Formatting the Chat in EssentialsX
To further customize chat appearance, edit the chat format in EssentialsX’s config.yml
.
Locate the chat
section and modify the format
option to control how messages appear in chat. Here’s an example:
- {PREFIX}: Displays the prefix from LuckPerms.
- {DISPLAYNAME}: Shows the player’s display name (this can also reflect Essentials nicknames).
- {MESSAGE}: Displays the player’s message.
You can add text or other placeholders to further customize this format.
Step 3: Installing Vault for Compatibility
EssentialsX requires Vault to interface with LuckPerms for prefix and suffix management.
- Download Vault from Vault’s official Bukkit page.
- Place the Vault
.jar
file in theplugins
folder of your server. - Restart your server.
With Vault installed, EssentialsX can now fetch prefix and suffix information from LuckPerms.
Step 4: Testing the Setup
- Join your Minecraft server as a player with a temporary prefix.
- Send a message in chat to confirm the prefix appears correctly.
- Wait until the expiration time (or reduce it to a few minutes for testing) and verify that the prefix disappears as expected.
If the prefix does not display correctly, double-check that:
- LuckPerms, Vault, and EssentialsX are correctly installed and running.
- Permissions in LuckPerms allow the player to have the prefix.
- EssentialsX’s
config.yml
hasadd-prefix-suffix
set totrue
.
Additional Tips
- Using Chat Formatting Plugins: If you want more customization options, consider adding a chat formatting plugin like ChatControl or DeluxeChat.
- LuckPerms Web Editor: LuckPerms has an online editor for easier management. Run
/lp editor
in-game to get a link to the editor interface. - Custom Permissions Groups: Assign temporary prefixes to entire groups instead of individual players using:
By following this guide, you should now have a fully functional auto-expiring prefix system integrated with EssentialsX, LuckPerms, and Vault. This setup provides an enhanced chat experience, with customizable formatting and temporary rank prefixes, perfect for adding a professional touch to any Minecraft server!