Installing and Configuring Better Chat on a Rust Server

Why Better Chat is worth installing

A Rust server without organized chat looks unfinished. Owners blend in with regular players, admins have no way to flex their role, and donor perks are invisible to the rest of the lobby. The Better Chat plugin fixes that by introducing groups with their own prefixes, username colors, and message formats. It hooks into uMod and gives you full control over how each rank appears in the in-game chat.

It is one of those plugins that feels small at first, then becomes the backbone of how your community recognizes staff and supporters. The good news is that uploading it through your server panel is straightforward, and most of the heavy work happens through a handful of console commands.

Uploading the plugin to your server

Grab the plugin file from the official uMod page for Better Chat and click Download.

Save it somewhere easy to find on your computer. You will only need it for a moment, so the desktop is fine.

Open your control panel and head to the file manager in the panel sidebar. Double check that you are on the correct server profile before continuing, because uploading the plugin to the wrong profile is the most common cause of it failing silently.

Log in with your panel password and open the `oxide` directory.

From there, enter the `plugins` folder and click Upload near the top left. Drag the `.cs` file you downloaded into the upload window.

Wait for the transfer to reach 100 percent, then go back to the main panel and Restart the server.

Rust plugins only load when uMod Support is enabled in the server settings of your panel. It is on by default, but it is worth a quick look before you restart.

First steps after installation

If you log in expecting fireworks, prepare to be underwhelmed. Better Chat does nothing visible until you configure groups and assign people to them. All of that is handled through commands, although the plugin also drops two JSON files in case you prefer editing settings by hand.

Running the commands

You can execute Better Chat commands from inside the game if you are an admin, or directly from the console section of your panel. Either path works, and many owners end up using both depending on what they are doing.

To grant yourself admin permissions for the plugin, run the following from the console:

`oxide.grant user [player/SteamID] betterchat.admin`

There is a single permission node for the entire plugin, which keeps things simple. If you want a deeper refresher on oxide permissions, the wider guide on plugin permissions is a good companion.

Understanding group settings

Before you start spamming `/chat group set`, it helps to know which attributes you can actually tweak. Each group can carry its own username color, title, title color, message color, and priority value. The examples below show how those pieces fit together once the group exists.

Useful command examples

The examples below are written for in-game use. If you run them from the panel console, drop the leading slash but keep the rest of the syntax identical.

Start by creating a rank with `/chat group add [group]`. There is no cap on how many groups you can create, so feel free to map out owner, admin, moderator, builder, VIP, and whatever donor tiers you offer.

Once the group exists, add players to it with `/chat user add [player/Steam ID] [group]`. The change shows up in chat almost immediately, even if you have not customized the rank yet.

If someone needs to be removed, the matching command is `/chat user remove [player/Steam ID] [group]`. Keep the roster tight, especially for groups that hand out elevated permissions elsewhere.

Flavor a rank with a custom username color using `/chat group set [group] UsernameColor [color/HEX]`. The new color may not pop up right away because priority decides which group wins when a player belongs to several.

To make sure your new rank actually beats the default one, raise the default priority with `/chat group set default Priority [value]` and give your custom groups a lower number. Lower numbers win.

Editing the plugin files directly

Commands cover most use cases, but the JSON files give you finer control over formatting, particularly when you want spaces or special characters that the command parser does not handle well.

Open the panel and open the file manager again, then browse into `/oxide/data`.

Click Edit next to `BetterChat.json` to open the data file.

Make the changes you need for each group and Save at the top of the editor.

When you are done there, head back to the main `oxide` folder and open the `config` directory. Edit the `BetterChat.json` file inside that folder to access the plugin's core settings.

Save again, return to the main panel, and Restart the server so the new values load.

Customizing the chat format

The format string controls exactly how a message renders for each group. The default is `{Title} {Username}: {Message}`, which is fine for testing but boring for a serious server. Symbols, brackets, emojis, and color tags are all fair game, but the command-based editor only accepts a single value argument. That means anything involving spaces or complex spacing should be done directly in the data file rather than through `/chat group set`.

Things that go wrong

The plugin does not load. Confirm the file landed in `/oxide/plugins` for the active server profile. A mismatched profile dumps the file somewhere the server never reads. Also verify that uMod Support is still enabled in your panel settings, then restart.

Commands return syntax errors. This usually points at the format string or another group setting. Because the parser only accepts one value, multi-word arguments need to be edited inside `BetterChat.json` instead. For everything else, check for typos in player IDs and group names, and consider running the command from the panel console where copy paste is more forgiving.

You cannot run any commands in-game. Most likely you do not hold the `betterchat.admin` permission yet. Hop into the console and grant it with `oxide.grant user [player/SteamID] betterchat.admin`. Every command can also be executed from the console directly, so you do not actually need to be logged into the game to manage groups.

Further reading

• Better Chat on uMod
• Adding plugins to a Rust server
• Becoming an admin on a Rust server
• Connecting to your Rust server through FTP