Commands & Permissions
Manage all aspects of ChatColor with these commands and their associated permissions.
Commands
The base command for the plugin is /color, with aliases: /chatcolor and /cc.
| Command | Description | Permission |
|---|---|---|
/color |
Opens the main color selector GUI | chatcolor.use |
/color gui [player] |
Opens the color selector for you or others | chatcolor.use* |
/color reset [player] |
Removes active chat color | chatcolor.use* |
/color set <type> <key> [player] |
Sets a color, gradient, or pattern by key | chatcolor.use* |
Valid Types: color (or solid), gradient, pattern.
Example: /color set gradient sunset or /color set solid red BusyBee.
| /color create <name> <tag> <icon> [permission] | Create a new custom color | chatcolor.create |
| /color reload | Reloads all plugin configuration | chatcolor.reload |
*Using [player] argument requires chatcolor.admin permission.
Console Usage
When running commands from the server console, you must specify a target player for any command that affects a player's color or opens a GUI.
| Command | Console Support | Notes |
|---|---|---|
/color |
❌ No | Use /color set instead. |
/color gui <player> |
✅ Yes | Opens the GUI for the specified player. |
/color reset <player> |
✅ Yes | Resets color for the specified player. |
/color set <type> <key> <player> |
✅ Yes | Sets color for the specified player. |
/color create ... |
✅ Yes | Works exactly as it does in-game. |
/color reload |
✅ Yes | Works exactly as it does in-game. |
Permissions
General Permissions
| Permission | Description | Default |
|---|---|---|
chatcolor.use |
Access to the GUI and basic commands | true |
chatcolor.reload |
Reload the plugin configuration files | op |
chatcolor.create |
Allows creating custom colors via command | op |
chatcolor.admin |
Use admin arguments (like [player]) |
op |
chatcolor.minimessage |
Use MiniMessage tags & legacy colors in chat | false |
Group Default Permissions
Assign default colors to specific groups using these permission nodes. The colors and groups are defined in config.yml.
| Permission | Description | Default |
|---|---|---|
chatcolor.group.<name> |
Apply the default color defined for | false |
Wildcard Permissions
| Permission | Description | Default |
|---|---|---|
chatcolor.color.* |
Access to all solid colors | op |
chatcolor.gradient.* |
Access to all gradients | op |
chatcolor.pattern.* |
Access to all patterns | op |
GUI Access Permissions
Control access to specific sections of the main menu GUI.
| Permission | Description | Default |
|---|---|---|
chatcolor.gui.solid |
Access to the Solid Colors section | true |
chatcolor.gui.gradient |
Access to the Gradients section | true |
chatcolor.gui.pattern |
Access to the Patterns section | true |
Entry-Specific Permissions
Each individual color, gradient, and pattern has its own permission node for granular control. These are defined in colors.yml and patterns.yml.
Examples:
- Solid Color:
chatcolor.color.red - Gradient:
chatcolor.gradient.sunset - Pattern:
chatcolor.pattern.rainbow