ChatColor
Description:
ChatColor allows players to change the colour and style of their chat to many different things! Colour your chat in over 16 million different colours, with all Minecraft colours, modifiers and hex colours supported!
Plugin Support
If you need some help or support with the plugin, please join my support Discord server here: https://discord.gg/hNBtt9cDk4
Features:
- Change the colour of your players' chat message to over 16 million different possibilities.
- Supporting legacy, hex, rainbow, and gradient colours, giving you maximum customisability.
- All modifiers including bold, italic, underlined, and even obfuscated if you really want it, are available.
- MySQL & MariaDB support - keep your colours the same across all of your servers.
- Supports setting colours from console - easy to include as a donor purchase reward.
- Complete set of permissions allowing for fine control over player access to colours.
- Custom colour system to make it easier to create and save your favourite hex, rainbow, or gradient colours.
- Group colour system to enable permission-based set colours
- Fully customisable plugin messages.
- Fully customisable GUI for advanced colour selection.
- Settings to modify plugin functionality.
- Helpful and friendly author! Always here to help where I can.
Note: See below for help on commands, permissions, colours, modifiers and settings!
Commands:
Key:
- <value> = Required value.
- [value] = Optional value.
Main Command:
- /chatcolor [player] <color/default> [modifiers] - Change yours or a player's chat colour!
- For a custom colour, use: /chatcolor [player] %<name>
The name is defined in the custom-colors.yml config file. - Note: Please see here for information on hex colours! The format is like so: &#RRGGBB, where each character after the # must be a number or letter between 0-9 and a-f.
Admin Commands:
- /chatcolor permissionshelp - Shows permissions help!
- /chatcolor settingshelp - Shows settings help!
- /chatcolor reload - Reloads all configs, use if you changed them while running!
- /chatcolor reset - Use with caution, resets the config to the default!
- /chatcolor set <setting> <value> - Changes one of the many settings! (See below for details)
- /chatcolor confirm - Confirms a setting change.
- /chatcolor group <add/remove/list> [name] [color] - Adds, removes, or lists group colours. You can use these to give groups a chat color through permissions (see below).
- /chatcolor custom <add/remove/list> [name] [color] - Adds, removes, or lists custom colours. The color must be a valid custom color string.
Other Commands:
- /chatcolor - Shows your current chat colour!
- /chatcolor gui - Open a GUI for selecting your desired colour!
- /chatcolor <add/remove> <modifier> - Adds or removes a modifier from your chat colour.
- /chatcolor available - Shows your available colours and modifiers!
- /chatcolor commandshelp - Shows command help! You can also use /chatcolor help.
Customisable GUI:
- The GUI is fully customisable in the config file gui.yml.
- There are instructions for creating your own GUIs as well as three example GUIs (one for normal colours, one for hex colours and one for custom colours) ready to go in the config.
- Feel free to drop me a message if you need any help!
Settings:
- command-name - Changes the base command to whatever you want!
- color-override - Changes whether ChatColor overrides '&' colour symbols in messages.
- confirm-timeout - Changes the time that players get when making a decision.
- default-color - Changes the colour that all players get when joining (also one-time sets all players).
- join-message - Changes if players are told their colour when joining.
- notify-others - Changes whether players are told if their chat colour is changed by someone else.
- auto-save - Changes whether the plugin will auto-save to files every 5 minutes, in case of a crash
- save-interval - Sets the time interval between saves for the plugin.
- force-custom-colors - Changes whether the plugin will force custom colours to be used. Note: This is actually group colours not custom colours.
- command-opens-gui - If set to true, /chatcolor will open the GUI instead of telling you your colour.
Colours & Modifiers:
Valid Colours:
- 0 or black
- 1 or dark.blue
- 2 or green
- 3 or dark.aqua
- 4 or red
- 5 or purple
- 6 or gold
- 7 or grey
- 8 or dark.grey
- 9 or blue
- a or light.green
- b or aqua
- c or light.red
- d or magenta
- e or yellow
- f or white
- All hex colours, in the format #RRGGBB
Valid Modifiers:
- k or obfuscated
- l or bold
- m or strikethrough
- n or underlined
- o or italic
Permissions:
- chatcolor.* - Grants a player all ChatColor permissions. Please note that you cannot use a custom colour if you have this permission!
- chatcolor.use - Allows a player to use /chatcolor and /chatcolor cmdhelp.
- chatcolor.use-color-codes - Allows a player to use & colour codes in the chat.
- chatcolor.use-hex-codes - Allows a player to use hex codes to color their chat (allows ALL colours!).
- chatcolor.special - Allows a player to use rainbow and gradient colours via the /chatcolor command. Does not allow use of preset custom colours.
- chatcolor.gui - Allows use of the GUI to select a colour.
- chatcolor.color.* - Allows a player to use all colours.
- chatcolor.color.<color> - Allows a player to use colour.
- chatcolor.modifier.* - Allows a player to use all modifiers.
- chatcolor.modifier.<modifier> - Allows a player to use a modifier.
- chatcolor.change.* - Allows a player to change everyone's chat color.
- chatcolor.change.self - Allows a player to change their own colour.
- chatcolor.admin - Allows a player to use all admin commands.
- chatcolor.group.<color-name> - Sets a player/group's group colour.
- chatcolor.custom.<color-name> - Gives a player access to a custom colour.
Note: You must use either numbers or letters found above for the colours and modifiers permissions.
PlaceholderAPI
Here are the different placeholders you can use for this plugin:
- %cc_full_color% - Returns the full colour (colour + modifiers) of a player. Can then be used to colorise text after it.
Note: Rainbow & gradient colours will not be displayed! - %cc_color% - Returns the colour only (no modifiers) of a player.
- %cc_color_name% - Returns the name or character of the player's colour, e.g. a, b, c, or %custom-name.
- %cc_colored_color_name% - Same as %cc_color_name%, but the colour is applied to the text returned.
- %full_color_name% - Returns the full word version of a player's colour, e.g. red, black, dark green.
- %colored_full_color_name% - Same as %cc_full_color_name%, but the colour is applied to the text returned.
- %cc_modifiers% - Returns the modifiers only (no colour) of a player. Can then be used to modify text after it.
- %cc_modifier_names% - Returns the modifier names, e.g. l, mn, lmn.
- %cc_modified_modifier_names% - Same as %cc_modifier_names%, but with the modifiers applied to the text returned.
- %cc_full_modifier_names% - Returns the full word version of a player's modifiers. e.g., bold, italic.
- %cc_modified_full_modifier_names% - Same as %cc_full_modifier_names%, but with the modifiers applied to the text returned.
- %cc_group% - Returns the player's current active group name, or "None" if there isn't one.
- %cc_<color/modifier>_available% - Returns either 'gui-available' or 'gui-unavailable' from the messages.yml, based on if the player has the necessary permission. e.g. %cc_a_available%
Videos
- Plugin showcase by Barbercraft!
Data Collection:
This plugin uses bStats to collect some statistics about usage of the plugin and sends them to https://bstats.org/. This can be disabled by changing 'stats' in the config.yml to false. The statistics sent include Version Demographics, Server/Player Statistics, Server Location, Operating System etc. The stats available to the public are Version Demographics, Server Location, Rank, Java Version and Global Statistics. These are viewable at https://bstats.org/plugin/bukkit/ChatColor2.
Bugs:
- If you find any bugs, please report them! Reports are very helpful so that I know what I'm doing wrong and what I need to fix!
- You can report bugs through GitHub, by direct message, or joining the support Discord server shown at the top of this page.
Hey! De plugin works fine and i like it, but it is spamming my console all the time. Do you have an idea how to fix this ?
Could not pass event InventoryClickEvent to ChatColor2 v1.9.3
org.bukkit.event.EventException
at org.bukkit.plugin.java.JavaPluginLoader$1.execute(JavaPluginLoader.java:302) ~[craftbukkit-1.8.8.jar:git-Bukkit-e1ebe52]
at org.bukkit.plugin.RegisteredListener.callEvent(RegisteredListener.java:62) ~[craftbukkit-1.8.8.jar:git-Bukkit-e1ebe52]
at org.bukkit.plugin.SimplePluginManager.fireEvent(SimplePluginManager.java:501) [craftbukkit-1.8.8.jar:git-Bukkit-e1ebe52]
at org.bukkit.plugin.SimplePluginManager.callEvent(SimplePluginManager.java:486) [craftbukkit-1.8.8.jar:git-Bukkit-e1ebe52]
at net.minecraft.server.v1_8_R3.PlayerConnection.a(PlayerConnection.java:1564) [craftbukkit-1.8.8.jar:git-Bukkit-e1ebe52]
at net.minecraft.server.v1_8_R3.PacketPlayInWindowClick.a(SourceFile:31) [craftbukkit-1.8.8.jar:git-Bukkit-e1ebe52]
at net.minecraft.server.v1_8_R3.PacketPlayInWindowClick.a(SourceFile:9) [craftbukkit-1.8.8.jar:git-Bukkit-e1ebe52]
at net.minecraft.server.v1_8_R3.PlayerConnectionUtils$1.run(SourceFile:13) [craftbukkit-1.8.8.jar:git-Bukkit-e1ebe52]
at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511) [?:1.8.0_212]
at java.util.concurrent.FutureTask.run(FutureTask.java:266) [?:1.8.0_212]
at net.minecraft.server.v1_8_R3.SystemUtils.a(SourceFile:44) [craftbukkit-1.8.8.jar:git-Bukkit-e1ebe52]
at net.minecraft.server.v1_8_R3.MinecraftServer.B(MinecraftServer.java:673) [craftbukkit-1.8.8.jar:git-Bukkit-e1ebe52]
at net.minecraft.server.v1_8_R3.DedicatedServer.B(DedicatedServer.java:335) [craftbukkit-1.8.8.jar:git-Bukkit-e1ebe52]
at net.minecraft.server.v1_8_R3.MinecraftServer.A(MinecraftServer.java:629) [craftbukkit-1.8.8.jar:git-Bukkit-e1ebe52]
at net.minecraft.server.v1_8_R3.MinecraftServer.run(MinecraftServer.java:537) [craftbukkit-1.8.8.jar:git-Bukkit-e1ebe52]
at java.lang.Thread.run(Thread.java:813) [?:1.8.0_212]
Caused by: java.lang.NoSuchMethodError: org/bukkit/event/inventory/InventoryClickEvent.getClickedInventory()Lorg/bukkit/inventory/Inventory; (loaded from file:/pro/bin/mc/craftbukkit/1.8.8/craftbukkit-1.8.8.jar by sun.misc.Launcher$AppClassLoader@46d478da) called from class com.sulphate.chatcolor2.listeners.ColorGUIListener (loaded from file:/home/gs-40413/plugins/ChatColor2-v1.9.3.jar by org.bukkit.plugin.java.PluginClassLoader@7f08d06b).
at com.sulphate.chatcolor2.listeners.ColorGUIListener.onEvent(ColorGUIListener.java:39) ~[?:?]
at sun.reflect.GeneratedMethodAccessor185.invoke(Unknown Source) ~[?:?]
at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) ~[?:1.8.0_212]
at java.lang.reflect.Method.invoke(Method.java:498) ~[?:1.8.0_212]
at org.bukkit.plugin.java.JavaPluginLoader$1.execute(JavaPluginLoader.java:300) ~[craftbukkit-1.8.8.jar:git-Bukkit-e1ebe52]
... 15 more
In reply to Forge_User_57265529:
I'm having the same problem as you!.
Hope he replies your comment.
In reply to Forge_User_57265529:
Hi! The plugin was not updated to work with 1.15. I have updated it to 1.16 now, let me know if you still need 1.15!
Whenever I try to do anything it says "/chatcolor [player] <color/default> [modifiers]"
I'm oped, can someone please help me?
In reply to TurtleRunsSlowMC:
This probably means the plugin didn't load correctly. Could you check your log for any errors?
Hello, this plugin is wonderful, but i have a problem. Well i've changed my color from magenta to dark aqua, when i send the message on chat, there's magenta. Someone can help?
Hi , I just installed this amazing plugin , but i have a problem , i added the "chatcolor.gui" perm to a specify group , so it would have access to open the gui and change the color of his mesages, but when i tried to do /chatcolor gui , it says "You do not have permission to use that command" , i added the "chatcolor.use-color-codes" and the "chatcolor.color.*" , but it still doesnt work and it still saying "You do not have permission to use that command, any fix? pls i love this plugin because its for the latest version and its amazing , but i dont know how to fix this. Thanks
In reply to jarshoowa692:
Make sure they also have chatcolor.use! I hope you enjoy using the plugin :)
I have a question. since you can force color for specific groups. default is color f
i added more groups, for admins etc to force color for them, but it doesnt work.
any help?
In reply to Forge_User_03543592:
Have you added the correct permissions to the groups, and made sure that they do not have the * or chatcolor.* permission?
Additionally, they can only have one custom color permission or it will select the first one alphabetically out of the ones that they have.
Hey, MCSulphate
How can you edit the color gui/colors? Because my colors.yml
is empty....
- Jornvbr
In reply to Forge_User_99178792:
Hi there! The GUI is not editable. The colors.yml file is for custom colours.
I'm sorry but I don't seem to see the permissions.yml file to change the permissions in my server, by default only admins can use the plugin but I would like to let my friends use it too... but I don't seem to know how to change the permissions with what command because with /chatcolor set won't let me input any of the chatcolor.gui perm for example...
In reply to Robhellspawn:
You need to use a permissions plugin, for example PermissionsEx. You can find it on Bukkit as well :)
Good luck!
In reply to Forge_User_05433798:
In reply to Forge_User_05433798:
yes I already got it, sadly, I've never used this type of plugins before so I still have no clue on how to fix it... is it in another config file now? or is everything made through chat
In reply to Robhellspawn:
You need to change the config in the PermissionsEx folder, or you can do it in-game. See this tutorial (https://github.com/PEXPlugins/PermissionsEx/wiki/Basic-Permissions-Setup) for more information.
Hope this helps :)
Hi, how do we code in custom colors? And, would it be possible to be able to make a custom color set that is a gradient like the rainbow option? (For example, the text goes between all blues.)
In reply to HaunterHexes:
Hey!
To add custom colours, use /chatcolor custom add <name> <color> <modifiers..>, then give the permission chatcolor.custom.<the name of the color you made>, and make sure force-custom-colors is set to true in the config.
Rainbow custom colours are coming in the next update!
Hey, I'm not sure why all of a sudden, but out of no where, ChatColor just stopped working. I haven't touched the yml files, and I even updated it to the latest version. ChatColor never worked for me, but I have an idea of how to make it work, by using ChatColor placeholders in my ChatControl plugin. This is the thing I get when I try to use any ChatColor command: /chatcolor [player] <color/default> [modifiers]
In reply to flimsynimsy:
That suggests that the plugin didn't load at all. If you could send a server log in DMs, that'd be awesome :) Thanks!