Custom roles
A custom role belongs to one member and to no one else. The server decides how many it opens and to whom; the member decides its name, colour and icon.
>customroleOverview
A custom role belongs to one member: they pick its name, colour and icon. The server only decides how many slots it opens and who gets them.
The system stays off until you switch it on. You can prepare everything without opening anything to members.
Getting started
Switch the system on
Until
>customrole enableis typed, nobody can claim a role. Set the levers first.>customrole enableSet the slots
The tabbed panel sets each lever with buttons and forms, without opening anything by default.
>customrole configClaim a role
A member who meets a condition creates their role, within their rate limit.
>customrole claim
How it works
The server sets how many slots are open, between 1 and 250. Each slot is a role a member can design.
To claim a slot, a member must meet at least one of the 3 entry conditions, read as OR. Then 9 actions open to them: name, colour, icon.
Each member has a rate: 3 changes per 2 minutes at most. Beyond that, they must wait for the window to free up.
A new server opens no slots, and nothing can be claimed while the switch is off.
With 3 changes per 2 minutes, a member can adjust their role, but cannot redo it in a loop.
Where it is set
Nothing is open by default. A new server opens no slot and has no anchor: while the system stays off, settings are prepared without opening anything.
- The switch
- Off by default Until
>customrole enableis typed, nobody can claim. You can set the levers before. - From Discord
- >customrole config A tabbed panel sets each lever with buttons and forms, counts the members each condition lets through, and lists the roles to rename or delete one.
- From the web
- Dashboard The same settings and the same role list, from the browser.
What a claim checks
A claim goes through six steps, in this order. The first one that refuses stops everything, and nothing is created.
- 01 The switch
Until
The system is on>customrole enableis typed, nobody claims. You can set the levers first. - 02 The anchor
Each created role is placed under it. Without it, no claim succeeds.
A reference role is set - 03 One role only
A member owns only one custom role. A role lent to you does not count as yours.
You own none here - 04 A free place
The server opens up to 250 places. Lending a role uses none.
250 places at most - 05 A condition passes
An EnderBot level, a server level or a required role is enough. With no condition, everyone passes.
3 doors, any one - 06 The role is created
The role is born with the default name, prefix included, placed under the anchor, then given back to you. If the grant or the saving fails, the created role is deleted.
Created then placed
Nine gestures open to the member
Each gesture is typed after >customrole. 3 of them share a counter: 3 changes per window of 2 minutes, per member.
>customrolename, color and icon share this counter, and color takes hexadecimal or one of the 141 CSS names. icon only opens on servers that have role icons. Claiming, lending, taking back and leaving a loan are not counted.
- Name, colour, icon 3 gestures, 3 changes per member
- Claim, lend, take back 6 gestures, no counter
The screen, for real
What >customrole information returns: your role if you have one, the roles lent to you, and the slot bar.
- Your role
- 100 characters at most The role, mentioned by name, with its colour in hexadecimal. The server prefix counts in this length.
- The counter
- Never more than 250 A bar shows the places taken out of those the server opened.
- Look
- Any member
informationshows your role, the roles lent to you and the counter. With the manage roles permission, it adds the settings.
Tips
- Set before you switch on
Every lever can be prepared without opening anything. Switch the system on once everything is ready.
- Count before you open
The panel counts the members each condition lets through. Read that number before you open the slots.
- Conditions add up
Read as OR, they stack: each extra condition lets more members in.
Reference
The exact figures, open them when you need them.
The server levers Each lever is set from the panel or the dashboard. Slots run from 1 to 250. A new server opens none.
For the whole server
A lever left unset keeps its default.
| Lever | Accepts | Default | What it changes |
|---|---|---|---|
| Reference role | A server role | None | Each role created is placed under it. While it is missing, no claim succeeds. |
| Open slots | From 1 to 250 | 0 | The number of live roles on the server, all members combined. |
| Prefix | Free text | None | Stuck in front of each name, 32 characters at most. It counts toward the 100 characters of the name. |
| EnderBot level | A player level | None | The game level the account must carry, not the server's. |
| Server level | A local tier | None | The tier of the local scale, the one messages and voice raise. |
| Required roles | A list of roles | Empty | Holding any one listed role opens the gate. The list adds to the other two conditions. |
Commands
| Command | Effect |
|---|---|
>customrole | Manage custom roles in this server |
>customrole claim | Claim a custom role slot |
>customrole configure | Configure the custom role system |
>customrole grant | Grant your custom role to another user |
>customrole information | View custom role system info and your role status |
Going further
Neighbouring pages, for what weighs on roles.
The local tier a condition sets.
Who may type which command, and where.
Put forward the messages people like.