NastyColor

NastyColor | Custom Chat Colors & Name Gradients

Customize your Minecraft server with NastyColor! Give your players access to beautiful chat colors and name gradients, with configurable color options, permission-based access, and support for popular chat formatting and tab list plugins.

✨ Key Features

• Custom Chat Colors: Let players personalize their chat messages with the available color options.
  
  
• Name Color Customization: Give players unique name colors using configurable gradients.
  
  
• Custom Gradients: Create your own gradients with multiple HEX colors directly in the configuration.
  
  
• Permission-Based Colors: Control exactly which chat colors and name colors each player can use.
  
  
• LuckPerms Support: Easily assign individual color permissions to players or ranks.
  
  
• Chat Plugin Integration: Display custom name and chat colors through supported chat formatting plugins.
  
  
• Tab List Integration: Display colored player names in the tab list using your tab formatting configuration.
  
  
• Configurable Color Styles: Customize gradient colors, menu item materials, shadow options, and more.
  
  
• Flexible Rank Rewards: Offer exclusive colors and gradients to VIPs, MVPs, staff, or other ranks.
  

Commands
Player Commands

• /chatcolor — Open the chat color selection menu.
  
  
• /namecolor — Open the name color selection menu.
  

Players can select only the colors for which they have permission.

Permissions
NastyColor uses individual permissions for color selection.

Permission format:

• nastycolor.chatcolor.<colorname> — Allows the player to equip a specific chat color.
  
  
• nastycolor.namecolor.<colorname> — Allows the player to equip a specific name color.
  

Replace <colorname> with the actual color key defined in your configuration.

Example: Granting Colors with LuckPerms
Give a player permission to use the junglegreen chat color:

/lp user PlayerName permission set nastycolor.chatcolor.junglegreen true
Give the same player permission to use the junglegreen name color:

/lp user PlayerName permission set nastycolor.namecolor.junglegreen true
Replace PlayerName with the player's Minecraft username.

Important: These permissions grant access to the specified color. The player must still select or equip it using the relevant NastyColor command/menu.

Rank-Based Color Permissions
You can also give a color to an entire rank:

/lp group vip permission set nastycolor.chatcolor.junglegreen true
/lp group vip permission set nastycolor.namecolor.junglegreen true
This allows members of the vip group to access these colors, provided your NastyColor permission checks and LuckPerms setup match these nodes.

What about OP players?

OP players can use colors when the plugin's permission defaults or operator permissions grant access. If you want to restrict colors to explicitly authorized players, configure the permissions accordingly and test with an OP account as well as a normal player.

Creating Custom Gradients
NastyColor lets server owners configure their own gradient colors instead of being limited to a fixed set of colors.

For example, you can create a Jungle Green gradient.

Example: junglegreen
Add the following entry to the relevant color section in your NastyColor configuration:

junglegreen:
material: green_candle
color: "#02DD1A,#0EDD2C,#0AA215,#066701"
shadow: false
Configuration options:

• junglegreen — The unique color key used in permission nodes.
  
  
• material — The Minecraft item displayed for this color in the selection menu.
  
  
• color — The HEX colors used to create the gradient, separated by commas.
  
  
• shadow — Controls the color option's shadow setting, if supported by the installed version.
  

After adding the color, grant players access using:

/lp user PlayerName permission set nastycolor.chatcolor.junglegreen true
/lp user PlayerName permission set nastycolor.namecolor.junglegreen true
Follow your installed NastyColor version's configuration structure and reload or restart the server as required.

More Gradient Ideas
Ocean Blue

oceanblue:
material: light_blue_candle
color: "#12CFFF,#00AEEF,#007CFF"
shadow: false
Royal Purple

royalpurple:
material: purple_candle
color: "#B517FF,#8415F3,#5715F3"
shadow: false
Sunset

sunset:
material: orange_candle
color: "#FF3535,#FF8C42,#FFD166"
shadow: false
These are example gradient entries. Place them under the same parent section as junglegreen in your actual configuration; do not replace the entire configuration file with these snippets.

Chat Color Integration
To display NastyColor's selected name color and chat color in chat, configure your compatible chat formatting plugin to use the NastyColor placeholders.

Example Chat Format
chat-format: "{prefix}%nastyname_color%&r &7» %nastycolor_chatcolor%{message}"
Placeholder breakdown:

• {prefix} — Displays the player's rank prefix, if provided by your chat plugin.
  
  
• %nastyname_color% — Displays the player's selected name color.
  
  
• &r — Resets formatting to prevent unwanted color inheritance.
  
  
• &7» — Adds a gray separator between the name and message.
  
  
• %nastycolor_chatcolor% — Applies the player's selected chat color.
  
  
• {message} — Displays the actual chat message.
  

Example in-game appearance:

[VIP] PlayerName » Hello everyone!

The player's name and message colors depend on their selected NastyColor options.

Note: The example uses the placeholder names and format syntax provided for this setup. Your chat plugin must support the relevant placeholders and formatting syntax. Placeholder support can vary by plugin.

Display Name Colors in the Tab List
To display the selected NastyColor name color in the tab list, add the following placeholder to your compatible tab formatting configuration:

customtabname: '%nastycolor_namecolor%'
This is a configuration example for a setup that supports customtabname. Your tab plugin may use a different setting name or require the player's actual name to be appended to the placeholder.

Make sure the relevant placeholder is registered and supported by your installed NastyColor version. If your tab plugin requires PlaceholderAPI, install and configure it as required by that integration.

⚙️ Installation

1. Download the NastyColor JAR.
   
   
2. Place it in your server's plugins folder.
   
   
3. Restart the server.
   
   
4. Open the generated NastyColor configuration and review the available colors.
   
   
5. Add your custom gradients using the existing configuration structure.
   
   
6. Grant the appropriate permissions through LuckPerms.
   
   
7. Configure your chat and tab plugins to display the NastyColor placeholders.
   
   
8. Test the color selection with both authorized and unauthorized accounts.
   

❓ Support
Need help setting up NastyColor, creating custom gradients, configuring permissions, or integrating chat and tab formatting?

Discord Support: https://discord.gg/YRv82vqbzW

Replace the example invite with your actual Discord support server link.

‍ Credits
Author: Nastyboyyy

Thank you for using NastyColor!