EssentialsX Per-Group Kit Permissions

How Kit Permissions Work in EssentialsX

Every kit defined in EssentialsX has an automatic permission node: essentials.kits.<kitname>. By assigning these nodes to specific LuckPerms groups, you control which ranks can claim which kits. This essentialsx kit permissions per group approach is cleaner than using the built-in kit delay system alone because it integrates with your existing rank hierarchy.

Defining Kits in config.yml

Kits live in plugins/Essentials/config.yml under the kits section. Here is an example with three rank-specific kits:

kits:
  starter:
    delay: 86400
    items:
      - stone_sword 1
      - leather_chestplate 1
      - bread 16
      - torch 32
  member:
    delay: 43200
    items:
      - iron_sword 1
      - iron_chestplate 1
      - cooked_beef 32
      - torch 64
      - experience_bottle 16
  vip:
    delay: 21600
    items:
      - diamond_sword 1 sharpness:2
      - diamond_chestplate 1 protection:2
      - golden_apple 8
      - experience_bottle 64

The delay is in seconds: 86400 = 24 hours, 43200 = 12 hours, 21600 = 6 hours. Players cannot claim the kit again until the cooldown expires.

Assigning Permissions with LuckPerms

Now assign essentialsx kit permissions per group using LuckPerms commands:

# Default rank gets only the starter kit
/lp group default permission set essentials.kits.starter true

# Member rank gets starter + member kit
/lp group member permission set essentials.kits.starter true
/lp group member permission set essentials.kits.member true

# VIP gets all three kits
/lp group vip permission set essentials.kits.starter true
/lp group vip permission set essentials.kits.member true
/lp group vip permission set essentials.kits.vip true

If your groups use inheritance (member inherits from default, vip inherits from member), you only need to add the new kit permission at each level. The inherited permissions carry upward automatically.

Using Inheritance

# With inheritance, you only add the new permission at each rank
/lp group default permission set essentials.kits.starter true
/lp group member permission set essentials.kits.member true
/lp group vip permission set essentials.kits.vip true

Per-Group Cooldown Overrides

EssentialsX also supports the essentials.kit.exemptdelay permission, which bypasses kit cooldowns entirely. You can assign this to staff or high-tier donors. For finer control, use different kit names with different delays rather than trying to override the delay per group.

Kit GUI Integration

If you use a GUI menu plugin (like DeluxeMenus or ChestCommands), you can display only the kits a player has permission for by checking essentials.kits.<name> as a view permission on each menu item. This way, players see only the kits available to their rank.

Testing Your Setup

1. Create a test account or use /lp user <name> parent set default to reset a player to the default group.
2. Run /kit and confirm only the starter kit is listed.
3. Promote the player: /lp user <name> parent set member.
4. Run /kit again and confirm both starter and member kits appear.
5. Repeat for each rank to verify the full essentialsx kit permissions per group chain.

Common Issues

• Kit not showing up: check that the kit name in config.yml is lowercase and matches the permission node exactly.
• Cooldown not working: verify the delay value is in seconds, not minutes.
• Items not giving enchantments: use the format item amount enchantment:level with no spaces around the colon.

For general EssentialsX setup, see How to Set Up EssentialsX. For permission hierarchy design, check the Minecraft LuckPerms Permissions Guide.

See these configs in action: Astroworld MC, IP play.astroworldmc.com, Java + Bedrock.