Features Roles & nicknames
Role added, prefix on. Role removed, prefix off.
Map a role to a nickname prefix and names stay in sync — never doubled, highest role wins. Post role menus members press themselves, with staff roles refused on every press. Gate it all behind rules they actually have to read.
01 · Why it exists
Three manual steps that get half-done
A new member is renamed, given roles and labelled in separate manual steps. Some get all three, some get one, and six weeks later nobody knows whether [Recruit] means anything.
What half-done labels cost
The nickname prefix is how your officers read the member list at a glance — who is staff, who is a recruit, who is an ally. When it is applied by hand it drifts: promoted members keep old tags, departed tags linger, and the one officer who did the renaming goes on holiday.
Ping roles have the opposite problem. Members want them, staff have to hand them out, and the queue of "can I get the ZvZ ping" messages never ends — or worse, someone gets Manage Roles just to self-serve, which is how privilege creep starts.
Both jobs are mechanical, which is exactly why a bot should hold them: the prefix follows the role the moment it changes, and the menu hands out only the roles you pre-approved, checked again on every press.
Only you can see this
02 · Setup
Map it once, then it runs itself
Two admin screens — Nicknames and Roles in /settings — and everything after is automatic or member-driven.
-
Map roles to prefixes admin
In
/settings → Nicknames, map a role to a prefix: the officer role to[O], the recruit role to[Recruit]. From then on nicknames follow role changes automatically — role added, prefix on; role removed, prefix off. When several mapped roles apply, the highest role position wins. -
Run Sync now for the members you already have admin
A one-press sweep brings existing members in line and reports exactly what it skipped and why — bots, the server owner, a role above the bot’s, or missing Manage Nicknames. Nothing is silently skipped.
-
Build a role menu admin
In
/settings → Roles, name a menu, pick its roles and its mode. Post it in any channel as a board — or attach it to an application type, and it lands in the applicant’s thread when they are approved. On approve, not on apply, so a declined applicant can never self-assign anything. -
Members press, the bot answers privately member
Pressing answers with a private copy of the menu where the roles you hold are ticked and green. The shared board is never edited — one message cannot show fifty people fifty different states.
-
Optionally, gate applications on your rules admin
Point an application type at your rules post and pick a mode: agree before the form opens, or agree in the thread, where approval is hard-blocked until they click ✅ I Agree. Acceptance is recorded against a version number.
03 · Nickname prefixes
Never doubled, never fighting your members
Map the officer role to [O] and the recruit role to [Recruit], and nicknames follow role changes — including removals, which strip the prefix again.
Only you can see this
The rules the sweep lives by
Never doubled. `[GG] Name` stays `[GG] Name`, never `[GG] [GG] Name` — and an existing accidental double is collapsed rather than preserved.
Highest role wins. When several mapped roles apply to one member, the prefix comes from the highest role position — an officer who is also a recruit reads as an officer.
Members keep their own names. The bot never fights a nickname a member set for themselves. The one deliberate exception is the approval moment on an application, where an operator has just confirmed their in-game name.
Skips are named. Discord never lets a bot rename the server owner, and hierarchy blocks anyone whose highest role sits above the bot's. The sweep reports each skip with its reason instead of quietly moving on.
05 · The rules gate
Make them actually read the rules
Point an application type at your rules post and applicants click ✅ I Agree — before the form opens, or in their thread where approval is hard-blocked until they do.
Only you can see this
One choice, recorded against a version
The mode is one exclusive choice — Off, before the form, or in the thread — rather than two toggles, because two on/off buttons allow a redundant both-on state and cannot show the current selection at a glance.
In-thread mode hard-blocks approval until they agree; deny is unaffected. The review card shows ✅ Agreed (vN) or ⏳ Not yet agreed — approval blocked, so officers see consent at a glance.
Acceptance is recorded against a version number, and re-asking is driven by an explicit Bump version button — the only honest signal, since the bot cannot see that you edited a linked Discord post. Underneath it is a reusable ledger keyed by an opaque policy string, so other features can adopt the same mechanism later.
06 · Honest limits
The limits, up front
07 · Questions
Questions officers actually ask
What is the difference between the roles an application grants and a role menu?
Will the bot rename someone who set their own nickname?
We changed our rules. Does everyone have to agree again?
What does this need from the bot in Discord?
See it running before you install
The community server runs the bot in the open — a live killboard, real boards to press, and humans who answer questions.
Keep reading
Features that work with this one
Stop renaming people by hand
Map the prefixes once, post the menus once, and the server keeps itself labelled.