Server · Concept

Custom roles

The role a member draws for themselves: a name, a colour, and the slot the server opens for them.

In short

A custom role belongs to one member and to them alone. The server decides how many it opens and for whom; the member decides the name and the colour.

A member owns 1 custom role, never two. They claim it, name it, colour it, and may lend it to other members without those members ever owning it.

Slots are counted for the whole server, not per member. A fresh server opens 0: until that number is raised, nobody claims anything. The ceiling is 250.

The server may set up to three entry conditions: an EnderBot level, a server level, a list of roles. They read as OR, so meeting a single one is enough.

The life of a role fits in eight moves: claim it, name it, colour it, lend it, take it back, give it up.

1

Six levers for the whole server

Two doors set the same levers. Nothing is open by default: a fresh server carries 0 slot and no anchor.

>customrole configure
From Discord
One lever per subcommand, plus enable and disable for the switch.
Dashboard
From the web
The same page sets everything at once, with a role picker instead of mentions.
LeverWhat it takesDefaultWhat it changes
Reference role A role of the serverNoneEvery created role is filed right below it. While it is missing, no claim goes through.
Open slots From 1 to 2500The number of live roles on the server, all members together.
Prefix Free textNoneGlued in front of every name; prefix included, the whole stays under 100 characters.
EnderBot level A player levelNoneThe game level to reach, the one the account carries rather than the server.
Server level A local tierNoneThe tier of the local ladder, the one messages and voice climb.
Required roles A list of rolesEmptyWearing a single one of the listed roles opens the door; the list never stacks, it adds itself to the two other conditions.
  • The system stays off until >customrole enable is typed: the six levers can be set beforehand, they only act once the switch is open.
2

What the claim checks

A claim walks six steps in this order: the first one that refuses stops everything, and nothing is created.

1
The system is open
Nothing happens while the server switch is off.
  • >customrole enable has been typed
2
An anchor exists
The reference role says where the new role will be filed.
  • A reference role is set
3
You do not already own one
A member who already owns a role cannot claim a second one.
  • You own no role here
4
A slot is left
The count of live roles must stay under the open slots, 0 at first and 250 at the ceiling.
  • Live roles sit under the open slots
5
One condition passes
The 3 gates read as OR: meeting a single one is enough, and a server that sets none lets everyone through.
  • Your EnderBot or server level reaches the tier
  • Or you wear one of the listed roles
6
The role is created
The role is born, filed under the anchor, then handed to you. If any of these three steps fails, the created role is deleted.
  • The Discord role is created
  • It is filed under the anchor, then comes to you
Slots returned
At once
A role given up or deleted reopens its slot within the second, with no setting to touch.
Lent role
Zero slots
Lending your role to other members consumes no slot: only ownership counts.
Roles per member
1
Owning a role closes the door on a second one, even when slots are still open.
  • A server that sets no condition leaves the condition gate open: only the anchor and the free slot are left to pass.
  • A member who leaves the server loses their role: the Discord role is deleted, its slot reopens, and the loans they had granted fall with it.
3

Eight moves, a single counter

One command, >customrole, followed by the word below. Every gesture shares the same pace: 3 actions per 2 minutes, per member.

claim Claim. Walks the six steps, creates the role under the anchor and hands it to you.
Any member
name Rename. Rewrites the role name, the server prefix counting toward the character budget.
The owner
color Recolour. Changes the colour, in hexadecimal or by a CSS name.
The owner
grant Lend. Gives the role to another member, who wears it without ever owning it.
The owner
revoke Take back. Takes the role back from a borrower, touching neither ownership nor the slot.
The owner
unclaim Give up. Deletes the Discord role and reopens its slot. Borrowers lose it in the same move.
The owner
abandon Step out. Gives back a role lent by someone else, without their consent and without deleting it.
A borrower
information Look. Shows the state of the system, the slots left and what your own role carries.
Everyone
  • A colour is written in hexadecimal (#7c3aed, #7ae) or by name: 141 CSS names are recognised.
4

The screen, for real

What >customrole information sends back: the state of the system, your role with its prefix kept under 100 characters, and the moves left to you.

EnderBot
EnderBot BOT Today at 11:41 AM

Custom roles

System open · Anchored under @Regular · Prefix ✦ · Server level 5 required
✦ Keeper of the Lake · #7c3aed · lent to 2 members
6 / 9 slots taken
🌐 Dashboard
  • The title

    The name of the system, never the name of your role.

  • The server state

    What the server has set: the switch, the anchor, the prefix, the conditions in place.

  • Your role

    The full name, server prefix included, and the colour it carries.

  • The counter

    The slots taken out of those the server opened, never more than 250.

  • The dashboard button

    A single link button, the only control the screen carries: the rest of the work happens on the web page.

  • The screen only offers the moves your state allows: with no role it offers to claim, with a role it offers to name and colour it.

The commands

>customrole
>customroles

Manage custom roles in this server · servers only

claim Claim a custom role slot
configure Configure the custom role system
grant Grant your custom role to another user
  • <user> The user to grant the role to
information View custom role system info and your role status
Also abandoncolordisableenablenamerevokeunclaim