Server

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.

>customrole
≤ 250 role slots at most
3 per 2 min edits per member
3 conditions entry conditions, read as OR
9 gestures open to the member
00

Overview

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.

01

Getting started

  1. Switch the system on

    Until >customrole enable is typed, nobody can claim a role. Set the levers first.

    >customrole enable
  2. Set the slots

    The tabbed panel sets each lever with buttons and forms, without opening anything by default.

    >customrole config
  3. Claim a role

    A member who meets a condition creates their role, within their rate limit.

    >customrole claim
02

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.

What it means

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.

03

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 enable is 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.
04

What a claim checks

A claim goes through six steps, in this order. The first one that refuses stops everything, and nothing is created.

  1. 01
    The switch

    Until >customrole enable is typed, nobody claims. You can set the levers first.

    The system is on
  2. 02
    The anchor

    Each created role is placed under it. Without it, no claim succeeds.

    A reference role is set
  3. 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
  4. 04
    A free place

    The server opens up to 250 places. Lending a role uses none.

    250 places at most
  5. 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
  6. 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
A member who leaves the server loses their custom role: the role is deleted, their slot reopens, and the loans they had granted fall with it. A loan they had received is erased too.
05

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.

2 minutes
The change counter >customrole

name, 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
06

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 information shows your role, the roles lent to you and the counter. With the manage roles permission, it adds the settings.
07

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.

08

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.

LeverAcceptsDefaultWhat 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
CommandEffect
>customroleManage custom roles in this server
>customrole claimClaim a custom role slot
>customrole configureConfigure the custom role system
>customrole grantGrant your custom role to another user
>customrole informationView custom role system info and your role status
09

Going further

Neighbouring pages, for what weighs on roles.

Server levels

The local tier a condition sets.

Command rules

Who may type which command, and where.

Starboard

Put forward the messages people like.

A custom role does not live alone: it depends on the level, the commands and the server's honour board.