Skip to content
yurna
  1. Documentation
  2. Automations
  3. Auto nicknames

Auto nicknames

Nicknames by rules – on join, on roles, after verification; with numbers like “Cadet 4821”.

SetupDashboardRolesAutomation

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#

  1. Open Auto nicknames (/dashboard/<server>/auto-nicks) and turn the module on at the top right.
  2. 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.
  3. Choose the trigger, the role if needed, and adjust the template. The live preview on the right shows what “yurna” would be called.
  4. Save. New rules act from now on for every matching event.
  5. 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#

TriggerApplies …
On jointo all members – set on join, on “Apply to everyone” and as fallback
Role gainedwhile the member has the role
Role lostfrom losing the role until another rule takes over
On verificationafter 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#

PlaceholderMeaning
{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 4821 again. 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