Permissions

The Custom Commands plugin uses a comprehensive permission system that allows you to control access to commands and features. This guide covers all permission nodes and how to set them up.

Permission Structure

The plugin uses a hierarchical permission system with clear naming conventions:

customcommands.*                    # All permissions (OP only)
customcommands.use                  # Basic usage (default: true)
customcommands.reload               # Reload configuration (OP only)
customcommands.help                 # View help (default: true)
customcommands.version              # View version (default: true)
customcommands.info                 # View info (default: true)
customcommands.support              # View support (default: true)
customcommands.admin                # Administrative access (OP only)

# Custom command permissions
customcommands.discord              # Discord command
customcommands.website              # Website command
customcommands.rules                # Rules command
customcommands.example              # Example command

# Subcommand permissions
customcommands.discord.send         # Discord send subcommand
customcommands.discord.invite       # Discord invite subcommand
customcommands.discord.help         # Discord help subcommand

Core Permissions

customcommands.*

Description: Grants all permissions for the Custom Commands plugin
Default: OP only
Children: All other permissions

This is the master permission that grants access to all plugin features.

customcommands.use

Description: Allows basic usage of the plugin
Default: true (all players)

This permission is required to use the main /customcommands command.

customcommands.reload

Description: Allows reloading configuration files
Default: OP only

This permission is required to use /customcommands reload.

customcommands.help

Description: Allows viewing help information
Default: true (all players)

This permission is required to use /customcommands help.

customcommands.version

Description: Allows viewing version information
Default: true (all players)

This permission is required to use /customcommands version.

customcommands.info

Description: Allows viewing plugin information
Default: true (all players)

This permission is required to use /customcommands info.

customcommands.support

Description: Allows viewing support information
Default: true (all players)

This permission is required to use /customcommands support.

customcommands.admin

Description: Grants administrative access to all features
Default: OP only

This permission provides access to all administrative functions.

Custom Command Permissions

customcommands.discord

Description: Allows using the discord command
Default: true (all players)

Required to use /discord command and its aliases (/dc).

customcommands.website

Description: Allows using the website command
Default: true (all players)

Required to use /website command and its aliases (/web, /site).

customcommands.rules

Description: Allows using the rules command
Default: true (all players)

Required to use /rules command and its aliases (/rule).

customcommands.example

Description: Allows using the example command
Default: true (all players)

Required to use /example command and its aliases (/ex, /demo).

Subcommand Permissions

Discord Subcommands

customcommands.discord.send

Description: Allows using the discord send subcommand
Default: true (all players)

Required to use /discord send command.

customcommands.discord.invite

Description: Allows using the discord invite subcommand
Default: true (all players)

Required to use /discord invite command.

customcommands.discord.help

Description: Allows using the discord help subcommand
Default: true (all players)

Required to use /discord help command.

Setting Up Permissions

With LuckPerms

LuckPerms is the recommended permissions plugin for modern Minecraft servers.

Basic Setup

# Give basic usage to all players
/lp group default permission set customcommands.use true

# Give specific commands to all players
/lp group default permission set customcommands.discord true
/lp group default permission set customcommands.website true
/lp group default permission set customcommands.rules true

# Give admin permissions to operators
/lp group admin permission set customcommands.* true

Advanced Setup

# Create custom groups
/lp creategroup vip
/lp creategroup moderator

# Give VIP players access to example command
/lp group vip permission set customcommands.example true

# Give moderators reload permission
/lp group moderator permission set customcommands.reload true

# Give specific player permissions
/lp user PlayerName permission set customcommands.discord.send true

Permission Inheritance

# Set up group inheritance
/lp group moderator parent add default
/lp group admin parent add moderator

# This means:
# - default gets basic permissions
# - moderator gets default + moderator permissions
# - admin gets moderator + admin permissions

With PermissionsEx

PermissionsEx is another popular permissions plugin.

Basic Setup

groups:
  default:
    permissions:
      - customcommands.use
      - customcommands.discord
      - customcommands.website
      - customcommands.rules
      - customcommands.help
      - customcommands.version
      - customcommands.info
      - customcommands.support

  vip:
    permissions:
      - customcommands.example
    inheritance:
      - default

  moderator:
    permissions:
      - customcommands.reload
    inheritance:
      - default

  admin:
    permissions:
      - customcommands.*
    inheritance:
      - moderator

With GroupManager

GroupManager is a simpler permissions plugin.

Basic Setup

groups:
  Default:
    permissions:
      - customcommands.use
      - customcommands.discord
      - customcommands.website
      - customcommands.rules
      - customcommands.help
      - customcommands.version
      - customcommands.info
      - customcommands.support

  VIP:
    permissions:
      - customcommands.example
    inheritance:
      - Default

  Moderator:
    permissions:
      - customcommands.reload
    inheritance:
      - Default

  Admin:
    permissions:
      - customcommands.*
    inheritance:
      - Moderator

Permission Examples

Server Owner Setup

# Give yourself all permissions
/lp user YourName permission set customcommands.* true

# Or add yourself to admin group
/lp user YourName parent add admin

Staff Setup

# Give moderators reload permission
/lp group moderator permission set customcommands.reload true

# Give moderators all command permissions
/lp group moderator permission set customcommands.discord true
/lp group moderator permission set customcommands.website true
/lp group moderator permission set customcommands.rules true
/lp group moderator permission set customcommands.example true

Player Setup

# Give all players basic commands
/lp group default permission set customcommands.discord true
/lp group default permission set customcommands.website true
/lp group default permission set customcommands.rules true

# Give VIP players example command
/lp group vip permission set customcommands.example true

Custom Command Permissions

# Create custom command with specific permission
# In config.yml:
customcommands:
  shop:
    permission: "customcommands.shop"
    # ... other settings

# Give permission to players
/lp group vip permission set customcommands.shop true

Permission Troubleshooting

Common Issues

Permission Not Working

Problem: Player gets “no permission” message

Solutions:

Check permission spelling
Verify player has the permission
Check permission plugin is working
Use /customcommands reload

Permission Inheritance Issues

Problem: Player doesn’t inherit permissions from group

Solutions:

Check group inheritance setup
Verify player is in correct group
Check for conflicting permissions
Use permission plugin debug commands

Permission Plugin Conflicts

Problem: Multiple permission plugins installed

Solutions:

Use only one permission plugin
Remove conflicting plugins
Check plugin load order
Restart server after changes

Debug Commands

LuckPerms Debug

# Check player permissions
/lp user <player> permission check customcommands.discord

# Check group permissions
/lp group <group> permission check customcommands.discord

# Show all permissions
/lp user <player> permission info

PermissionsEx Debug

# Check player permissions
/pex user <player> check customcommands.discord

# Show all permissions
/pex user <player> list

Best Practices

Permission Organization

Use Groups - Organize permissions by groups rather than individual players
Inheritance - Use group inheritance to avoid duplication
Naming - Use clear, consistent permission names
Documentation - Document your permission structure

Security Considerations

Least Privilege - Give only necessary permissions
Regular Audits - Review permissions regularly
Test Changes - Test permission changes before applying
Backup - Keep backups of permission configurations

Performance Tips

Efficient Groups - Don’t create too many groups
Cache Permissions - Use permission plugin caching
Avoid Wildcards - Use specific permissions when possible
Regular Cleanup - Remove unused permissions

Permission Templates

Basic Server

# All players get basic commands
default:
  permissions:
    - customcommands.use
    - customcommands.discord
    - customcommands.website
    - customcommands.rules
    - customcommands.help
    - customcommands.version
    - customcommands.info
    - customcommands.support

# Staff get reload permission
staff:
  permissions:
    - customcommands.reload
  inheritance:
    - default

# Admins get everything
admin:
  permissions:
    - customcommands.*
  inheritance:
    - staff

VIP Server

# Basic players get limited commands
default:
  permissions:
    - customcommands.use
    - customcommands.discord
    - customcommands.website
    - customcommands.help
    - customcommands.version
    - customcommands.info
    - customcommands.support

# VIP players get additional commands
vip:
  permissions:
    - customcommands.rules
    - customcommands.example
  inheritance:
    - default

# Staff get admin commands
staff:
  permissions:
    - customcommands.reload
  inheritance:
    - vip

# Admins get everything
admin:
  permissions:
    - customcommands.*
  inheritance:
    - staff

Next Steps

Now that you understand the permission system:

Read the Configuration Guide - Learn how to create custom commands
Check out Examples - See practical permission examples
Explore Commands - Learn about available commands

For support and updates, join our Discord server.