# Custom Commands Plugin [Folia Support]<\/p>\n
A powerful and feature-rich custom commands plugin for Paper\/Spigot servers with advanced functionality including nested subcommands, arguments system, player validation, console command execution, clickable links, and Folia Support!<\/p>\n
## Features<\/p>\n
### Custom Commands
\n– Create unlimited custom commands with permissions, aliases, and cooldowns
\n– Individual permission system for each command
\n– Support for command aliases (e.g., `\/dc` for `\/discord`)
\n– Configurable cooldowns to prevent spam
\n– Folia Supported!<\/p>\n
### Nested Subcommands
\n– Add tab-completed subcommands to any custom command
\n– **Unlimited nesting depth** – subcommands can have their own subcommands!
\n– Individual permissions for each subcommand level
\n– Smart tab completion system
\n– Example: `\/admin player kick`, `\/admin server restart`<\/p>\n
### Arguments System
\n– Add arguments to commands and subcommands
\n– Use `{args}` variable in messages and commands
\n– Whitelist support for allowed arguments
\n– Required\/optional argument configuration
\n– Support for arguments with spaces
\n– Example: `\/say hello`, `\/kick Steve`, `\/teleport Player 100 64 200`<\/p>\n
### *Player Arguments (`player-args`)
\n– Mark specific arguments as player names
\n– **Automatic validation** – ensures players exist and are online
\n– **Smart tab-completion** – shows all online players automatically
\n– Clear error messages for invalid players
\n– Works with nested subcommands
\n– Example: `\/kick Steve` (validates Steve is online)<\/p>\n
### Console Command Execution
\n– Execute any server command through custom commands
\n– Choose execution type: “Console” (as server) or “Player” (as user)
\n– Variable replacement system:
\n – `{player}` – Player name
\n – `{displayname}` – Player display name
\n – `{world}` – Player’s world name
\n – `{x}`, `{y}`, `{z}` – Player coordinates
\n – `{online_players}` – Number of online players
\n – `{max_players}` – Maximum players
\n – `{args}` – Command arguments<\/p>\n
### Clickable Links ### **Modern Text Formatting** ### Advanced Features ## Example Commands<\/p>\n ### Nested Subcommands with Arguments<\/p>\n “`yaml **Usage:** ### Discord Command with Subcommands<\/p>\n “`yaml ### Command with Arguments<\/p>\n “`yaml **Usage:** ### Command with Player Validation<\/p>\n “`yaml **Usage:** ### Example Command with Console Commands<\/p>\n “`yaml ## Installation ## Commands ## Permissions # Configuration<\/p>\n The plugin creates detailed configuration files with examples and documentation:<\/p>\n – `config.yml` – Main configuration with command definitions ## Requirements & Compatibility<\/p>\n ### **Compatibility Rating**<\/p>\n – Folia 1.21.x: **Fully supported** (v1.1.0+) ### Not Supported<\/p>\n – **Spigot** – This plugin uses `paper-plugin.yml` and requires Paper-specific APIs ## Important Notes<\/p>\n – **No Liability**: The developer takes no responsibility for crashes or issues on custom Paper\/Folia forks ## Documentation<\/p>\n The configuration files include comprehensive documentation with:<\/p>\n – Color code reference ## Perfect For<\/p>\n – Server owners wanting custom commands with advanced features <\/p>\n","protected":false},"excerpt":{"rendered":" A powerful custom commands plugin with subcommands, console command execution, and clickable links. Create unlimited custom commands with variable replacement, permissions, and modern text formatting for your Paper server.<\/p>\n","protected":false},"featured_media":36227,"template":"","meta":{"_minecraft_slug":"c-commands","_minecraft_project_id":"XRwXgh5o","_minecraft_author":"kzlyth","_minecraft_license":"Apache-2.0","_minecraft_downloads":2075,"_minecraft_follows":7,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"c-commands.zip","_minecraft_size_bytes":619477,"_minecraft_version_count":9,"_minecraft_updated_at":"2026-05-16T06:12:00.931022Z","_minecraft_date_created":"2025-10-26T22:15:38.764032Z","_minecraft_date_modified":"2026-02-02T19:06:58.300760Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/c-commands","_minecraft_icon_attachment_id":36227,"_minecraft_imported_at":"2026-06-01T17:55:42+00:00","_minecraft_import_hash":"77ae57b55da8470885977147d61d4cf0","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[125,126,127,128,123,92],"mod_loader":[131,132,133],"minecraft_version":[57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-36226","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-folia","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-technology","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n– Support for clickable links in messages
\n– Custom syntax: `(Display Text)[
\n– Opens URLs in player’s browser
\n– Works in both main commands and subcommands<\/p>\n
\n– Full Kyori Adventure API integration
\n– Support for hex colors (`&#FF8800`)
\n– Legacy color codes (`&6`, `&c`, etc.)
\n– JSON tellraw support with clickable elements<\/p>\n
\n– Hot-reload configuration without server restart
\n– Custom logging system with colored console output
\n– File rotation for log files
\n– Comprehensive error handling
\n– Asynchronous command execution
\n– **Folia server support** (v1.1.0+)<\/p>\n
\nadmin:
\n permission: “customcommands.admin”
\n subcommands:
\n player:
\n permission: “customcommands.admin.player”
\n subcommands: # Nested subcommands!
\n kick:
\n permission: “customcommands.admin.player.kick”
\n arguments:
\n player-args: [0] # First argument = player name
\n no-arguments: false
\n commands:
\n – “kick {args} Kicked by {player}”
\n ban:
\n permission: “customcommands.admin.player.ban”
\n arguments:
\n player-args: [0]
\n no-arguments: false
\n commands:
\n – “ban {args} Banned by {player}”
\n“`<\/p>\n
\n– `\/admin player kick Steve` – Kicks Steve (validates player is online)
\n– `\/admin player ban Steve` – Bans Steve (validates player is online)<\/p>\n
\ndiscord:
\n permission: “customcommands.discord”
\n alias: [“dc”]
\n subcommands:
\n send:
\n commands:
\n – “msg {player} &6Discord: &bhttps:\/\/discord.gg\/example”
\n invite:
\n message:
\n – “&7Click here: (Join Discord)[https:\/\/discord.gg\/example]”
\n“`<\/p>\n
\nsay:
\n permission: “customcommands.say”
\n arguments:
\n whitelist: [“hello”, “goodbye”, “help”]
\n whitelist-only: true
\n no-arguments: true
\n commands:
\n – “say {player}: {args}”
\n“`<\/p>\n
\n– `\/say hello` – Valid (in whitelist)
\n– `\/say goodbye` – Valid (in whitelist)
\n– `\/say test` – Invalid (not in whitelist)<\/p>\n
\nkick:
\n permission: “customcommands.kick”
\n arguments:
\n player-args: [0] # First argument must be a player name
\n no-arguments: false
\n commands:
\n – “kick {args} Kicked by {player}”
\n“`<\/p>\n
\n– `\/kick Steve` – Valid (if Steve is online)
\n– `\/kick InvalidPlayer` – Error: “Player InvalidPlayer is not online or does not exist!”<\/p>\n
\nexample:
\n type: “Console”
\n commands:
\n – “say {player} used the example command!”
\n – “effect give {player} minecraft:glowing 10 1 true”
\n – “title {player} title [“”,{“text”:”Example!”,”color”:”gold”}]”
\n“`<\/p>\n
\n1. Download the plugin JAR file
\n2. Place it in your server’s `plugins` folder
\n3. Restart your server
\n4. Configure commands in `plugins\/CustomCommands\/config.yml`
\n5. Use `\/customcommands reload` to reload configuration<\/p>\n
\n– `\/customcommands` – Main command
\n– `\/customcommands reload` – Reload configuration
\n– `\/customcommands help` – Show help
\n– `\/customcommands support` – Show support information
\n– `\/customcommands version` – Show version info<\/p>\n
\n– `customcommands.*` – All permissions
\n– `customcommands.use` – Basic usage
\n– `customcommands.reload` – Reload configuration
\n– `customcommands.commandname` – Use specific command
\n– `customcommands.commandname.subcommand` – Use specific subcommand
\n– `customcommands.commandname.subcommand.nested` – Use nested subcommand<\/p>\n
\n – Includes comprehensive documentation for all features
\n – Examples for arguments, nested subcommands, and player-args
\n– `messages.yml` – All plugin messages
\n– `logs\/` – Plugin log files<\/p>\n
\n– Paper 1.21.4+: Fully supported and tested
\n– Paper 1.21.0-1.21.3**: Likely compatible (tested on 1.21.2-1.21.3)
\n– Paper 1.20.x**: Probably compatible (not tested)
\n– Paper 1.19.x: May work with minor issues (not tested)<\/p>\n
\n– **Custom Paper Forks** – Use at your own risk, no support provided
\n– **PlugMan** – Do not use PlugMan to load this plugin (Paper plugins not supported)<\/p>\n
\n– **Paper & Folia**: This plugin is designed for Paper and Folia servers (v1.1.0+)
\n– **No PlugMan**: Do not attempt to load this plugin with PlugMan (Plugman does not work on paper anyways)
\n– **Backup**: Always backup your server before installing plugins
\n– **Testing**: Test on a development server before using in production<\/p>\n
\n– Variable replacement guide
\n– Console command examples
\n– Clickable link syntax
\n– Subcommand creation guide
\n– **Arguments system documentation**
\n– **Nested subcommands guide**
\n– **Player-args feature explanation**<\/p>\n
\n– Servers needing console command integration
\n– Communities wanting modern text formatting
\n– Administrators needing flexible command systems
\n– **Servers requiring player validation in commands**
\n– **Complex command structures with nested subcommands**<\/p>\n