- Documentation
- Automations
- Auto nicknames
Auto nicknames
Nicknames by rules – on join, on roles, after verification; with numbers like “Cadet 4821”.
Auto nicknames sets nicknames automatically by rules. Example Star Wars server: everyone new is called Cadet 4821 (their own number), whoever gets the lieutenant role becomes Lieutenant 4821 – with the same number.
In the dashboard#
- Open Auto nicknames (
/dashboard/<server>/auto-nicks) and turn the module on at the top right. - Create rule – at the top you'll find a template gallery (Star Wars cadet, rank prefix, clan tag, numbered in order …). One click fills in the rule.
- Choose the trigger, the role if needed, and adjust the template. The live preview on the right shows what “yurna” would be called.
- Save. New rules act from now on for every matching event.
- For members who are already there: Apply to all existing members → Calculate preview shows how many would be renamed (with examples), then Apply to …. yurna renames at a throttled pace (about one name per second) and shows the progress.
Triggers#
| Trigger | Applies … |
|---|---|
| On join | to all members – set on join, on “Apply to everyone” and as fallback |
| Role gained | while the member has the role |
| Role lost | from losing the role until another rule takes over |
| On verification | after passing Discord's rules screening or yurna verification |
Each rule can also have conditions: “only if the member has these roles” and “only if they don't have these roles”.
Placeholders#
| Placeholder | Meaning |
|---|---|
{user} / {displayname} | display name (e.g. lylish) |
{username} | Discord name (e.g. lylithara) |
{number:4} | random 4-digit number (number = digits, 1–8). Remembered per member; optionally “only once per server”. |
{my_number} | the member's remembered number (e.g. for rank changes) |
{counter} / {counter:3} | running number in the server, optionally zero-padded (001). Start value under “Exceptions and counter”. |
{role} | name of the rule's role (otherwise the highest role) |
{server} | server name |
Letter case: {user:upper}, {user:lower}, {user:title} – or for the whole name under Letter case. The German names work too ({nummer:4}, {meine_nummer}, {zaehler}, {rolle}), as do the old {name} and {username}.
yurna never uses the server nickname as the base – otherwise prefixes would pile up with every rule. If a name is longer than 32 characters (Discord limit), yurna shortens the name with “…” first; prefix and number stay.
Rules in detail#
- Priority (0–999): if several rules match, the highest wins; on a tie, the one further up the list.
- Fallback: if the winning rule no longer matches (role removed), the next matching one applies – e.g.
Cadet 4821again. If none matches, the member gets their previous name back, but only if yurna's name is still there. - Assign once: if someone changes their name afterwards, theirs stays. Reapply on every change: yurna sets the name again on every matching change.
- Exceptions: roles that are never renamed (e.g. the team) and “exclude bots”.
- Plan: New Moon 3 rules, Half Moon 15, Full Moon 50. After a downgrade the lower rules pause; nothing is deleted.
Warning
yurna needs the Manage Nicknames permission and a role above the member’s highest role. Discord doesn't allow renaming the server owner – yurna skips them. If permissions are missing, the dashboard shows a notice.
Last updated on 21 November 2026