LuckPerms Setup

LuckPerms Setup Guide

This guide provides ready-to-use LuckPerms commands to quickly set up permissions for EliteEssentials.

Prerequisites

1. Install LuckPerms on your Hytale server
2. Enable Advanced Permissions mode in EliteEssentials config:

   "advancedPermissions": true

3. Reload EliteEssentials: /ee reload

Quick Setup

Step 1: Set Up Default Group (Everyone Permissions)

Copy and paste these commands into your server console or as an admin in-game:

/lp group default permission set eliteessentials.command.home.home true
/lp group default permission set eliteessentials.command.home.sethome true
/lp group default permission set eliteessentials.command.home.delhome true
/lp group default permission set eliteessentials.command.home.homes true
/lp group default permission set eliteessentials.command.home.limit.3 true
/lp group default permission set eliteessentials.command.tp.tpa true
/lp group default permission set eliteessentials.command.tp.tpahere true
/lp group default permission set eliteessentials.command.tp.tpaccept true
/lp group default permission set eliteessentials.command.tp.tpdeny true
/lp group default permission set eliteessentials.command.tp.rtp true
/lp group default permission set eliteessentials.command.tp.back true
/lp group default permission set eliteessentials.command.warp.use true
/lp group default permission set eliteessentials.command.warp.list true
/lp group default permission set eliteessentials.command.spawn.use true
/lp group default permission set eliteessentials.command.misc.msg true
/lp group default permission set eliteessentials.command.misc.motd true
/lp group default permission set eliteessentials.command.misc.rules true
/lp group default permission set eliteessentials.command.kit.use true

This gives all players 3 homes by default. Change limit.3 to limit.5 or limit.10 if you want more.

Step 2: Set Up Admin Group

Option A: Use Wildcard (Recommended)

The eliteessentials.admin.* wildcard acts as an admin bypass for ALL admin commands:

/lp creategroup admin
/lp group admin permission set eliteessentials.admin.* true

This single permission gives access to all admin commands including setspawn, setwarp, delwarp, god, heal, fly, and more.

Option B: Individual Permissions (Granular Control)

If you want fine-grained control over which admin commands are available:

/lp creategroup admin
/lp group admin permission set eliteessentials.admin.reload true
/lp group admin permission set eliteessentials.command.spawn.set true
/lp group admin permission set eliteessentials.command.warp.set true
/lp group admin permission set eliteessentials.command.warp.delete true
/lp group admin permission set eliteessentials.command.warp.admin true
/lp group admin permission set eliteessentials.command.kit.create true
/lp group admin permission set eliteessentials.command.kit.delete true
/lp group admin permission set eliteessentials.command.misc.god true
/lp group admin permission set eliteessentials.command.misc.heal true
/lp group admin permission set eliteessentials.command.misc.fly true
/lp group admin permission set eliteessentials.command.misc.flyspeed true
/lp group admin permission set eliteessentials.command.misc.broadcast true
/lp group admin permission set eliteessentials.command.misc.clearinv true
/lp group admin permission set eliteessentials.command.misc.sleeppercent true
/lp group admin permission set eliteessentials.command.tp.top true
/lp group admin permission set eliteessentials.command.spawn.protection.bypass true

Step 3: Add Users to Groups

/lp user <username> parent add admin

How the Admin Wildcard Works

When you set eliteessentials.admin.*, the plugin's isAdmin() check recognizes this and grants access to ALL admin commands, even though they're under the command namespace. This is by design and acts as a master admin bypass.

What eliteessentials.admin.* gives you:

• All admin commands (setspawn, setwarp, delwarp, god, heal, fly, etc.)
• Bypass for spawn protection
• Access to /ee reload
• Admin bypass for cooldowns/warmups (when combined with bypass permissions)

If you want even more control: You can skip the wildcard and set individual command permissions instead. This lets you create roles like "Moderator" (can fly/heal but not manage warps) or "Builder" (can use /top and /fly but nothing else).

Advanced Group Examples

VIP/Donor Group

Create a VIP group with extra perks:

/lp creategroup vip
/lp group vip parent add default
/lp group vip permission set eliteessentials.command.home.limit.10 true
/lp group vip permission set eliteessentials.command.tp.bypass.cooldown.rtp true
/lp group vip permission set eliteessentials.command.warp.bypass.cooldown true
/lp group vip permission set eliteessentials.command.kit.starter true
/lp group vip permission set eliteessentials.command.kit.vip true

Then add users to VIP:

/lp user <username> parent add vip

Moderator Group

Create a moderator group with some admin powers:

/lp creategroup moderator
/lp group moderator parent add default
/lp group moderator permission set eliteessentials.command.misc.fly true
/lp group moderator permission set eliteessentials.command.misc.heal true
/lp group moderator permission set eliteessentials.command.misc.broadcast true
/lp group moderator permission set eliteessentials.command.tp.top true
/lp group moderator permission set eliteessentials.command.spawn.protection.bypass true
/lp group moderator permission set eliteessentials.command.tp.bypass.cooldown true
/lp group moderator permission set eliteessentials.command.tp.bypass.warmup true

Builder Group

Create a builder group for creative building:

/lp creategroup builder
/lp group builder parent add default
/lp group builder permission set eliteessentials.command.misc.fly true
/lp group builder permission set eliteessentials.command.tp.top true
/lp group builder permission set eliteessentials.command.spawn.protection.bypass true
/lp group builder permission set eliteessentials.command.home.limit.20 true

Permission Categories Reference

Home Commands (Everyone)

eliteessentials.command.home.home          # /home
eliteessentials.command.home.sethome       # /sethome
eliteessentials.command.home.delhome       # /delhome
eliteessentials.command.home.homes         # /homes

Home Limits:

eliteessentials.command.home.limit.1       # 1 home
eliteessentials.command.home.limit.3       # 3 homes (recommended default)
eliteessentials.command.home.limit.5       # 5 homes
eliteessentials.command.home.limit.10      # 10 homes
eliteessentials.command.home.limit.unlimited  # Unlimited homes

Home Bypass:

eliteessentials.command.home.bypass.cooldown  # Bypass home cooldowns
eliteessentials.command.home.bypass.warmup    # Bypass home warmup

Teleport Commands (Everyone)

eliteessentials.command.tp.tpa            # /tpa
eliteessentials.command.tp.tpahere       # /tpahere
eliteessentials.command.tp.tpaccept      # /tpaccept
eliteessentials.command.tp.tpdeny        # /tpdeny
eliteessentials.command.tp.rtp           # /rtp
eliteessentials.command.tp.back          # /back
eliteessentials.command.tp.back.ondeath  # /back after death

Teleport Bypass:

eliteessentials.command.tp.bypass.cooldown           # Bypass all TP cooldowns
eliteessentials.command.tp.bypass.warmup             # Bypass all TP warmups
eliteessentials.command.tp.bypass.cooldown.rtp      # Bypass RTP cooldown only
eliteessentials.command.tp.bypass.cooldown.back     # Bypass back cooldown only
eliteessentials.command.tp.bypass.cooldown.tpa      # Bypass TPA cooldown only

Warp Commands

eliteessentials.command.warp.use          # /warp (Everyone)
eliteessentials.command.warp.list         # /warps (Everyone)
eliteessentials.command.warp.set          # /setwarp (Admin)
eliteessentials.command.warp.delete       # /delwarp (Admin)
eliteessentials.command.warp.admin        # /warpadmin (Admin)

Per-Warp Access:

eliteessentials.command.warp.<warpname>   # Access specific warp
# Example: eliteessentials.command.warp.pvp

Warp Bypass:

eliteessentials.command.warp.bypass.cooldown  # Bypass warp cooldowns
eliteessentials.command.warp.bypass.warmup    # Bypass warp warmup

Spawn Commands

eliteessentials.command.spawn.use                    # /spawn (Everyone)
eliteessentials.command.spawn.set                    # /setspawn (Admin)
eliteessentials.command.spawn.protection.bypass      # Bypass spawn protection (Admin)

Spawn Bypass:

eliteessentials.command.spawn.bypass.cooldown  # Bypass spawn cooldown
eliteessentials.command.spawn.bypass.warmup    # Bypass spawn warmup

Kit Commands

eliteessentials.command.kit.use                 # /kit (Everyone)
eliteessentials.command.kit.create              # /kitcreate (Admin)
eliteessentials.command.kit.delete              # /kitdelete (Admin)
eliteessentials.command.kit.bypass.cooldown     # Bypass kit cooldowns (Admin)

Per-Kit Access:

eliteessentials.command.kit.<kitid>   # Access specific kit
# Example: eliteessentials.command.kit.starter

Miscellaneous Commands

eliteessentials.command.misc.msg           # /msg, /reply (Everyone)
eliteessentials.command.misc.motd          # /motd (Everyone)
eliteessentials.command.misc.rules         # /rules (Everyone)
eliteessentials.command.misc.god           # /god (Admin)
eliteessentials.command.misc.heal          # /heal (Admin)
eliteessentials.command.misc.fly           # /fly (Admin)
eliteessentials.command.misc.flyspeed      # /flyspeed (Admin)
eliteessentials.command.misc.broadcast     # /broadcast (Admin)
eliteessentials.command.misc.clearinv      # /clearinv (Admin)
eliteessentials.command.misc.sleeppercent  # /sleeppercent (Admin)
eliteessentials.command.tp.top             # /top (Admin)

Admin Permissions

eliteessentials.admin.*                    # All admin permissions (wildcard)
eliteessentials.admin.reload               # /ee reload

Troubleshooting

Commands not working?

1. Make sure advancedPermissions: true in config.json
2. Run /ee reload after changing config
3. Check if LuckPerms is loaded: /lp info
4. Verify user has the group: /lp user <name> info

Check what permissions a user has

/lp user <username> permission info

Check what permissions a group has

/lp group <groupname> permission info

Still using simple mode?

If you want to go back to simple mode (OP/Everyone):

1. Set advancedPermissions: false in config.json
2. Run /ee reload
3. Commands will work based on OP status

Useful LuckPerms Commands

/lp creategroup <name>                           # Create a new group
/lp deletegroup <name>                           # Delete a group
/lp listgroups                                   # List all groups
/lp user <name> parent add <group>               # Add user to group
/lp user <name> parent remove <group>            # Remove user from group
/lp group <name> permission set <perm> true      # Add permission to group
/lp group <name> permission unset <perm>         # Remove permission from group
/lp group <name> parent add <parent>             # Make group inherit from another
/lp group <name> setweight <number>              # Set group priority (higher = more important)

Notes

• Wildcards: Using eliteessentials.admin.* gives all admin permissions
• Inheritance: Groups can inherit from other groups (e.g., VIP inherits from default)
• Priority: Higher priority groups override lower ones for chat formatting
• Per-item access: Use specific permissions for warps/kits to control access
• Bypass permissions: Great for VIP/donor perks without making them full admin

For a complete list of all permissions, see the Permissions page.