Coloured Chat gives you the possibilty of changing players ingame names & messages to whatever colour you/they desire.
Player name colours will now only show up if the player has the following permission: colouredchat.name.show.
Same goes for messages in which case you will need to grant: colouredchat.message.show.
If you want everyone to have these permissions use the commands below.
The following commands can only be run by an administrator or server console.
Player name colours will now only show up if the player has the following permission: colouredchat.name.show.
Same goes for messages in which case you will need to grant: colouredchat.message.show.
If you want everyone to have these permissions use the commands below.
- oxide.grant group default colouredchat.name.show
- oxide.grant group default colouredchat.message.show
Permissions
This plugin uses the permission system. To assign a permission, use oxide.grant <user or group> <name or steam id> <permission>. To remove a permission, use oxide.revoke <user or group> <name or steam id> <permission>.Name
- colouredchat.name.show - Allows players to have a different name colours in chat (not modify it)
- colouredchat.name.use - Allows players to change their name colour
- colouredchat.name.bypass - Allows players to bypass name hex code restrictions
- colouredchat.name.setothers - Allows players to set other players name colours
- colouredchat.name.random - Allows players to set randomized name colours to themselfs
- colouredchat.name.rainbow - Allows players to give themselfs the rainbow name colour
- colouredchat.name.gradient - Allows players to use name colour gradients
Message
- colouredchat.message.show - Allows players to have a different message colour in chat (not modify it)
- colouredchat.message.use - Allows players to change their message colour
- colouredchat.message.bypass - Allows players to bypass message hex code restrictions
- colouredchat.message.setothers - Allows players to set other players message colours
- colouredchat.message.random - Allows players to set randomized message colours to themselfs
- colouredchat.message.rainbow - Allows players to give themselfs the rainbow message colour
- colouredchat.message.gradient - Allows players to use message colour gradients
Chat Commands
Changing own player
For message colours just use the message colour command instead! (by default: /mcolour)- /colours - Prints out help
- /colour <hexcode> - Changes your colour to given hex code
- /colour clear/reset/remove - Resets your colour
- /colour gradient <hexCode1 hexCode2 hexCode3 ...> - Changes your colour to the given gradient colours
- /colour random - Changes your colour to random hex code
- /colour rainbow - Changes your colour to the rainbow colours
Changing other players
For message colours just use the message colour command instead! (by default: /mcolour)- /colour set <playerIdOrName> <hexcode> - Changes targets colour to given hex code
- /colour set <playerIdOrName> clear/reset/remove - Resets targets colour
- /colour set <playerIdOrName> gradient <hexCode1 hexCode2 ...> - Changes targets colour to given gradient
- /colour set <playerIdOrName> random - Changes targets colour to a random hex code
- /colour set <playerIdOrName> rainbow - Changes targets colour to the rainbow colours
Changing groups
For message colours just use the message colour command instead! (by default: /mcolour) Also remember that group colours will only show up on the player if he has not set a custom colour/ does not have the rainbow permission.The following commands can only be run by an administrator or server console.
- /colour group <groupName> <hexcode> - Changes group colour to given hex code
- /colour group <groupName> clear/reset/remove - Resets group colour
- /colour group <groupName> gradient <hexCode1 hexCode2 ...> - Changes group colour to given gradient
- /colour group <groupName> random - Changes group colour to a random hex code
- /colour group <groupName> rainbow - Changes group colour to the rainbow colours
Configuration
The settings and options can be configured in the ColouredChat file under the config directory. The use of an editor and validator is recommended to avoid formatting issues and syntax errors.Default Configuration
Setting Player Inactivity Data Removal (days) to 0 disables this feature.Black/- Whitelist Colour Ranges
Example
Above blocks the usage of any hexcode (simple colour but also gradient colour parts) all colours starting from #000000 and ending with #BBBBBB. You can bypass this restriction by granting colouredchat.name.bypass for names or by default as an admin. You can simple add more range blocksLocalization
The default messages are in the ColouredChat file under the lang/en directory. To add support for another language, create a new language folder (e.g. de for German) if not already created, copy the default language file to the new folder and then customize the messages.For Developers
Hooks
The dictionary is completly mutable. You can change and return the dictionary to override chat messages.- Player (IPlayer) - player sending the message
- ChatChannel (Chat.ChatChannel) - chat channel of the message
- Colour (string) - colour that the name will have if no gradient is used
- Name (string) - username that will be displayed in chat with gradient modification if used
- Message (string) - message that will be displayed in chat
Returning non null overrides the default behaviour (cancels the message being sent).
