How to Set Up LuckPerms on Your Hytale Server

LuckPerms has officially arrived for Hytale. The permissions plugin that became essential for Minecraft server management is now available in an early beta for Hytale, giving server owners the same powerful permission system they've come to rely on.

This guide walks you through installation, basic permission setup, configuring prefixes and suffixes, and the built-in chat formatting that's unique to the Hytale version.

What is LuckPerms?

LuckPerms is a permissions management plugin that lets you control exactly what players and groups can do on your server. Instead of relying on the basic operator system, you can create detailed permission structures with ranks, inheritance, and fine-grained access control.

The Hytale version is built on the same proven codebase as the Minecraft editions, so if you've used LuckPerms before, you'll feel right at home.

Installing LuckPerms for Hytale

Download LuckPerms for Hytale from CurseForge and install it like any other Hytale mod.

Once installed, start your server. LuckPerms will generate its configuration files automatically.

Important: OP No Longer Works

When LuckPerms is installed, the built-in Hytale permission system is replaced. This means:

• The /op command won't work
• The /perm command won't work
• You must use LuckPerms commands to manage all permissions

If you want to give yourself full admin access (similar to OP), run:

/lp user <your-username> permission set *

This grants all permissions to your account.

Creating Groups and Setting Permissions

Most servers organise players into groups like Member, VIP, Moderator, and Admin. Here's how to set that up.

Create your groups:

/lp creategroup member
/lp creategroup vip
/lp creategroup moderator
/lp creategroup admin

Set up inheritance (so admins inherit moderator permissions, moderators inherit VIP permissions, etc.):

/lp group admin parent add moderator
/lp group moderator parent add vip
/lp group vip parent add member

Add permissions to groups:

/lp group member permission set essentials.home true
/lp group moderator permission set essentials.kick true
/lp group admin permission set * true

Add a player to a group:

/lp user <username> parent set vip

Setting Up Prefixes and Suffixes

Prefixes appear before a player's name in chat, while suffixes appear after. Each prefix and suffix has a weight (priority number) — the higher the weight, the higher the priority.

Add prefixes to your groups:

/lp group admin meta addprefix 100 "&c[Admin] "
/lp group moderator meta addprefix 90 "&d[Mod] "
/lp group vip meta addprefix 80 "&a[VIP] "
/lp group member meta addprefix 10 "&7[Member] "

The weight numbers (100, 90, 80, 10) determine which prefix shows if a player belongs to multiple groups. An admin who's also in the VIP group will display the Admin prefix because 100 is higher than 80.

Add a suffix:

/lp group vip meta addsuffix 80 " &6★"

Remove a prefix:

/lp group admin meta removeprefix 100

To check what prefixes and suffixes a user has:

/lp user <username> meta info

Chat Formatting (Hytale Exclusive)

Unlike the Minecraft version, LuckPerms for Hytale includes a built-in chat formatter that's enabled by default. This means your prefixes and suffixes will appear in chat without needing an additional plugin.

The formatter is configured in your LuckPerms config.yml:

chat-formatter:
  enabled: true
  message-format: "<prefix><username><suffix>: <message>"

You can customise the format using these placeholders:

• <prefix> — the player's prefix
• <username> — the player's name
• <suffix> — the player's suffix
• <message> — the chat message

The formatter supports MiniMessage formatting for colours and styles. For example:

/lp user <username> meta setprefix 10 "<red>[ADMIN] "

If you want formatting to stop at a certain point rather than carry through the whole message, close the tag:

/lp user <username> meta setprefix 10 "<red>[ADMIN]</red> "

Troubleshooting Permissions

If a command or feature isn't working for a player, use the verbose feature to see exactly what permissions are being checked:

/lp verbose on

Perform the action that's failing, then check the output to see which permission node is being denied.

You can also use /help in-game, which shows available commands alongside their required permissions.

Known Issues and Caveats

Since this is an early beta, expect some rough edges:

• The integration with Hytale isn't as stable as the Minecraft versions yet
• Some methods in PermissionsModule may not work as expected
• If you're using other mods with chat formatting, disable their chat features and use LuckPerms' built-in formatter instead

Check the LuckPerms GitHub for the latest known issues and updates.

Quick Reference

LuckPerms brings proper permission management to Hytale servers. While it's still in early beta, the foundation is solid — and if you're familiar with LuckPerms from Minecraft, you'll have your server's permissions sorted in no time.