Custom Usernames
Custom usernames let you control how senders are displayed when their messages are relayed to other servers. You can use dynamic variables to include contextual information like the server name or the user’s role.
Username Pattern
The custom usernames pattern is a string that can contain dynamic variables wrapped in curly braces {}. When a message is relayed, the variables are replaced with the actual values.
Available Variables
| Variable | Description | Example Output |
|---|---|---|
{username} | The user’s Discord username | JohnDoe |
{nickname} | Personal /settings nickname, then server nickname, then display name | Johnny |
{serverName} | The name of the originating Discord server | Server Alpha |
{role} | The user’s first non-@everyone role name | Moderator |
{userId} | The user’s ID | 123456789 |
{channelId} | Origin channel ID | 987654321 |
{discriminator} | Legacy discriminator | 0001 |
!!!{variable} | Uppercased value of any variable | JOHNDOE |
Example Patterns
| Pattern | Result |
|---|---|
{username} | JohnDoe |
{username} [{serverName}] | JohnDoe [Server Alpha] |
{nickname} | {serverName} | Johnny | Server Alpha |
{username} - {role} | JohnDoe - Moderator |
[{serverName}] {nickname} | [Server Alpha] Johnny |
Using {serverName} in the pattern helps users identify which server a message came from, which is especially useful in large interserv groups with many servers.
Custom User Picture
Similar to the username pattern, you can set a custom user picture URL. The only available variable is:
| Variable | Description |
|---|---|
{userAvatarUrl} | The user’s Discord avatar URL |
By default, the user’s Discord avatar is used. You would typically only set a custom picture URL if you want to use a different image service or a custom avatar.
How to Configure
Via Dashboard
- Go to oraxbot.com/dashboard
- Select your server and group
- Under Basic Configuration, find the Custom Usernames field
- Enter your desired pattern using the variables above
- Save the changes
Via Discord
Username patterns are configured from the dashboard . /manage-group only exposes toggle settings.
Custom username patterns apply group-wide. They cannot be overridden per channel.