Commands

The Custom Commands plugin provides several built-in commands for managing and using the plugin. This guide covers all available commands and their usage.

Main Commands

/customcommands

The main command for the Custom Commands plugin.

Aliases: cc, customcmd

Permission: customcommands.use

Usage:

/customcommands [subcommand]

Subcommands:

help - Show help information
reload - Reload configuration files
version - Show plugin version
info - Show plugin information
support - Show support information

/cc

Short alias for the main command.

Permission: customcommands.use

Usage:

/cc [subcommand]

Subcommands

/customcommands help

Shows help information and available commands.

Permission: customcommands.help (default: true)

Usage:

/customcommands help
/cc help

Example Output:

[CustomCommands] === Custom Commands Help ===
/customcommands reload - Reload configuration files
/customcommands help - Show this help message
/customcommands version - Show plugin version
/customcommands support - Show support information
[CustomCommands] ==============================

/customcommands reload

Reloads all configuration files without restarting the server.

Permission: customcommands.reload (default: op)

Usage:

/customcommands reload
/cc reload

What Gets Reloaded:

config.yml - All command configurations
messages.yml - All message configurations
Permission settings
Debug settings

Example Output:

[CustomCommands] Reloading configuration files...
[CustomCommands] Configuration files reloaded successfully!

Error Handling: If reload fails, the plugin will:

Show an error message
Keep the previous configuration active
Log detailed error information

/customcommands version

Shows the plugin version and author information.

Permission: customcommands.version (default: true)

Usage:

/customcommands version
/cc version

Example Output:

[CustomCommands] Custom Commands v1.0.0
[CustomCommands] Author: Kzlyth

/customcommands info

Shows detailed plugin information.

Permission: customcommands.info (default: true)

Usage:

/customcommands info
/cc info

Example Output:

[CustomCommands] Custom Commands v1.0.0
[CustomCommands] Author: Kzlyth
[CustomCommands] Use /customcommands help for available commands

/customcommands support

Shows support information and Discord link.

Permission: customcommands.support (default: true)

Usage:

/customcommands support
/cc support

Example Output:

[CustomCommands] === Support Information ===
Discord Server: https://discord.gg/2qCMn6KHj4
Join our Discord for support and updates!
[CustomCommands] ==============================

Custom Commands

The plugin also registers all custom commands defined in config.yml. These commands are created dynamically based on your configuration.

Example Custom Commands

Based on the default configuration, these commands are available:

/discord

Shows Discord server information with clickable link.

Permission: customcommands.discord (default: true)

Aliases: dc

Usage:

/discord
/dc

Subcommands:

/discord send - Send Discord invite to DMs
/discord invite - Show clickable Discord link
/discord help - Show available subcommands

/website

Shows website link with clickable URL.

Permission: customcommands.website (default: true)

Aliases: web, site

Usage:

/website
/web
/site

/rules

Shows server rules.

Permission: customcommands.rules (default: true)

Aliases: rule

Usage:

/rules
/rule

/example

Example command demonstrating console command execution.

Permission: customcommands.example (default: true)

Aliases: ex, demo

Usage:

/example
/ex
/demo

Command Features

Tab Completion

All commands support tab completion:

Main commands show available subcommands
Subcommands show relevant options
Permission-based completion (only shows what player can use)

Permission System

Each command has its own permission node:

Main command: customcommands.commandname
Subcommand: customcommands.commandname.subcommandname
Admin commands: customcommands.admin

Cooldown System

Custom commands can have cooldowns:

Per-player cooldowns
Configurable duration
Custom cooldown messages
Zero cooldown for instant reuse

Error Handling

The plugin provides helpful error messages:

Command not found
Permission denied
Cooldown active
Command disabled

Command Examples

Basic Usage

# Show help
/customcommands help

# Reload configuration
/customcommands reload

# Check version
/customcommands version

# Get support
/customcommands support

Custom Command Usage

# Discord information
/discord
/dc

# Website link
/website
/web

# Server rules
/rules
/rule

# Example command
/example
/ex

Subcommand Usage

# Discord subcommands
/discord send
/discord invite
/discord help

# Short aliases
/dc send
/dc invite
/dc help

Troubleshooting

Common Issues

Command Not Found

Problem: Command doesn’t respond

Solutions:

Check if plugin is enabled: /plugins
Verify command spelling
Check if command is enabled in config
Use /customcommands reload

Permission Denied

Problem: “You don’t have permission” message

Solutions:

Check permission nodes
Verify player has correct permissions
Use a permissions plugin (LuckPerms, etc.)
Check permission format

Cooldown Active

Problem: “You must wait X seconds” message

Solutions:

Wait for cooldown to expire
Check cooldown setting in config
Set cooldown to 0 for no cooldown
Use different command if available

Debug Information

Enable Debug Mode

In config.yml:

debug:
  enabled: true
  console: true
  file: true

Check Logs

plugins/CustomCommands/logs/latest.log

Test Commands

# Test main command
/customcommands help

# Test reload
/customcommands reload

# Test custom commands
/discord
/website
/rules

Command Permissions

Permission Structure

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

Setting Permissions

With LuckPerms

# Give basic usage
/lp user <player> permission set customcommands.use true

# Give specific command
/lp user <player> permission set customcommands.discord true

# Give all permissions
/lp user <player> permission set customcommands.* true

With PermissionsEx

groups:
  default:
    permissions:
      - customcommands.use
      - customcommands.discord
      - customcommands.website
      - customcommands.rules

Next Steps

Now that you understand the command system:

Read the Configuration Guide - Learn how to create custom commands
Check out Examples - See practical command examples
Explore Permissions - Set up proper permission systems

For support and updates, join our Discord server.