Nickname sync
Optional. Generate Discord nicknames from a template that mixes Discord and Roblox values.
Template variables
Use {variableName} in the template. Unknown variables render as empty.
| Variable | Description |
|---|---|
| {robloxName} | Roblox username (e.g. Builderman). |
| {robloxDisplayName} | Roblox display name. Falls back to username if unset. |
| {discordName} | The Discord username (e.g. maple). |
| {discordGlobalName} | Discord global display name (e.g. Maple). |
| {groupRankName} | Name of the user's highest matched rank in a configured group. |
| {groupRankNumber} | Numeric rank (0–255) for the same. |
| {serverName} | The Discord server's display name. |
Examples
| Template | Result |
|---|---|
| {robloxName} | Builderman |
| [{groupRankName}] {robloxName} | [Admin] Builderman |
| {robloxDisplayName} | {serverName} | Maple | Maple Studios |
| rk{groupRankNumber} · {robloxName} | rk100 · Builderman |
Rules and edge cases
- Discord caps nicknames at 32 characters. We truncate with a trailing
…. - Whitespace gets normalised to single spaces and trimmed before truncation.
- If the template renders to an empty string, we fall back to the user's Discord username so the bot never tries to set a blank nickname.
- We can't change nicknames for users above the bot in the role hierarchy (Discord limit). That's logged but not retried.
- Nicknames are updated whenever role sync runs. Toggle nickname sync off in the dashboard if you only want roles to sync.