Better Chat

Customize chat colors, formatting, prefix and more

Total Downloads: 21,872 - First Release: Apr 21, 2015 - Last Update: Oct 2, 2017

4.98936/5, 94 likes
▶ Q & A

Q: Why do clan tags not show?
Please install the ClanTags plugin to show them with BetterChat: Clan Tags | Oxide

Q: I can't remove myself from the default/moderator/admin group
Oxide automatically adds players to their appropriate groups. Everybody is added to the default group. If you are just trying to hide the default title for your admins, please look for the HiddenIfNotPrimary setting.

▶ Installation

Better Chat is installed like every other plugin.
Download the BetterChat.cs file from the overview and drop it into your plugins folder (/oxide/plugins).
Once in the plugin folder, it will be automaticly loaded.

▶ Configuration

Once Better Chat is installed, a config file will be generated (/oxide/config/BetterChat.json).
It's recommended to use a JSON Editor for editing the config to prevent syntax errors. Online JSON Editor: JSON Editor Online - view, edit and format JSON online
Otherwise you can open the file with a code/text editor as Notepad++ and then validate the syntax using this website: JSONLint - The JSON Validator.

The file should look like this (in a code/text editor):
Code (Text):
  "Maximal Characters Per Message": 128,
  "Maximal Titles": 3
Every setting looks like this: "Key": Value
The key is the name/description of the setting while the value is the actual value you want to set it to.
For example, to enable the word filter, you see under/inside "Word Filter" { ... } there is "Enabled": false,
To enable it, you change it to "Enabled": true,

Below, the given configuration is explained:

  • Maximal Titles - the maximum amount of titles being displayed
  • Maximal Characters Per Message - self explanatory

▶ Setting up a group

For setting groups up, use the command 'chat'.
If you want to set it up in the chat, you need to grant yourself the permission 'betterchat.admin' and prefix the command with a slash (/).
You can grant yourself the permission by typing following command into the server console where you replace <Your name or ID> with your username or ID (Steam ID for most games):
'oxide.grant user <Your name or ID> betterchat.admin'
Now you can use the command '/chat' in the chat.

First of all, create the group you want.
Lets do that with the example of an admin group.
Remember, if you are setting your groups up in the chat, you need to prefix the command with a slash (/).

To create a group, type:
Code (Text):
chat group add admin
You should also set the priority of the group it is very important for the plugin. The priority is basicly the rank of the group and tells Better Chat which group should be prefered if you are in multiple groups.

The lower the number, the higher the actual priority, meaning 0 > 1.
As admin is currently our highest priority group, set it to 0, if there is a moderator group too, it'd be most likely set it to 1 there.
Code (Text):
chat group set admin priority 0
Now as the group was created you can add yourself to it.
Some games as for example Rust which have admins and moderator levels already, automaticly apply you to the "admin" or "moderator" group if you have that admin or moderator level.

To manually add us to the group, use:
Code (Text):
chat user add <Your name or ID> admin
Now as you are in the group, you can give yourself a nice looking title.
Code (Text):
chat group set admin title [Admin]
You can also change the color of the title, lets change it to red:
Code (Text):
chat group set admin titlecolor red
It's a nice [Admin] now.
The colors can be any HEX-Code color or a spelled HTML-Color.

The same with our name:
Code (Text):
chat group set admin namecolor red
To finish it, you should change the priority of the default group which was automaticly generated before, to 1 to be a lower priority than admin.
Code (Text):
chat group set default priority 1
There are many other group settings which can be set by using the 'chat group set' command:
  • Priority - rank of the group which tells the plugin which group to prefer if you are in multiple (the lower the number the higher the actual priority!)
  • TitleHiddenIfNotPrimary - if set to true, the title of the group is hidden, if the group is not the one which the highest priority of the groups you are in
  • Title - the groups title
  • TitleColor - the color of the title
  • TitleSize - the size of the title
  • TitleHidden - if set to true, the title of the group will never be shown
  • UsernameColor - the color of the username
  • UsernameSize - the size of the username
  • MessageColor - the color of the message
  • MessageSize - the size of the message
  • ChatFormat - the format/order of the chat message
  • ConsoleFormat - the format/order of the chat message when displayed in console or logs

You can also change those values by editing the groups file (/oxide/data/BetterChat.json)
Here, the same rules of editing apply as for the config file.

The default group file should look like this:
Code (Text):
  "GroupName": "default",
  "Priority": 0,
  "Title": {
  "Text": "[Player]",
  "Color": "#55aaff",
  "Size": 15,
  "Hidden": false,
  "HiddenIfNotPrimary": false
  "Username": {
  "Color": "#55aaff",
  "Size": 15
  "Message": {
  "Color": "white",
  "Size": 15
  "Format": {
  "Chat": "{Title} {Username}: {Message}",
  "Console": "{Title} {Username}: {Message}"
If you still have questions, you can ask them in the support thread.