Luckperms Permissions Yml For Essentials

2 min read 30-12-2024

Luckperms Permissions Yml For Essentials

This guide provides a sample LuckPerms permissions YAML configuration for commonly used EssentialsX plugins. Remember to adapt this to your specific server needs and plugin versions. Always back up your configuration files before making any changes.

Setting up the essentials

Before starting, ensure you have both LuckPerms and EssentialsX installed and configured correctly on your Minecraft server. This configuration assumes a basic understanding of LuckPerms' permission inheritance system and EssentialsX commands.

Basic Permissions

This section outlines fundamental permissions for EssentialsX, granting access to core features. These are generally safe starting points, but adjust as necessary for your server's role structure.

# Default group inheriting no permissions.
group: default
  permissions:
    - essentials.spawn
    - essentials.kit
    - essentials.tpa
    - essentials.tpaccept
    - essentials.msg
    - essentials.reply

# A group with more extended permissions.
group: member
  permissions:
    - essentials.*  # Grant all EssentialsX permissions
    - essentials.nick.bypass
  inheritance:
    - default

# A group with administrative privileges.
group: admin
  permissions:
    - essentials.admin
  inheritance:
    - member

Explanation of Permissions:

essentials.spawn: Allows teleporting to the spawn point.
essentials.kit: Allows using item kits.
essentials.tpa: Allows requesting teleport from other players.
essentials.tpaccept: Allows accepting teleport requests.
essentials.msg: Allows sending private messages.
essentials.reply: Allows replying to private messages.
essentials.*: A wildcard granting access to all EssentialsX commands (use cautiously).
essentials.nick.bypass: Allows bypassing nick restrictions (if enabled).
essentials.admin: Grants full administrative access (use with extreme caution).

Advanced Permissions and Customization

This section delves into more granular control over specific EssentialsX functionalities.

Teleportation Controls

Fine-tune teleportation permissions for better server management:

group: moderator
  permissions:
    - essentials.tp
    - essentials.tphere
    - essentials.back
    inheritance:
      - member

essentials.tp: Allows teleporting to other players.
essentials.tphere: Allows teleporting players to their location.
essentials.back: Allows returning to the previous location.

Economy Management

Implement permission-based control over economy features:

group: donator
  permissions:
    - essentials.eco.pay
    - essentials.eco.balance
    - essentials.eco.money
    inheritance:
      - member

essentials.eco.pay: Allows paying other players.
essentials.eco.balance: Allows checking balances.
essentials.eco.money: Allows money-related commands (may require additional configuration).

Other Notable Permissions

Explore additional permissions to customize further:

essentials.nick: Allows changing nicknames.
essentials.god: Grants god mode (invincibility).
essentials.fly: Allows flight.
essentials.sethome: Allows setting home locations.
essentials.home: Allows teleporting to home locations.
essentials.clearinventory: Allows clearing inventories.
essentials.ban: Allows banning players (use extremely cautiously).
essentials.kick: Allows kicking players.

Important Considerations

Inheritance: Effectively utilize LuckPerms' inheritance system to avoid redundancy. Higher-ranked groups inherit permissions from lower-ranked ones.
Wildcards: Use wildcards (*) sparingly. They can grant excessive permissions unintentionally.
Testing: Thoroughly test your configuration in a test environment before applying it to your live server.
Plugin Updates: Plugin updates might alter permissions. Regularly review and update your configuration.

This comprehensive guide provides a robust foundation for managing EssentialsX permissions with LuckPerms. Remember to adjust it according to your server's unique requirements and always prioritize security and best practices.