Whitelist
Entry form for the server, staff review and an approved role. Works for game servers and for closed communities.
With the whitelist, the person clicks Apply on the panel, answers the form and the application goes to staff to approve or reject. Whoever is approved gets a role, and that role is what grants access (Discord channels, a FiveM or MTA server linked to the bot).
Set it up in Whitelist > Settings and follow the applications in Whitelist > Applications.
Start with the basics ready
If the whitelist doesn't have a form yet, the top of the screen shows Want the bot to set it up for you?. Click Set it up for me and the bot creates:
- the Approved role, which whoever passes the whitelist gets;
- the #apply-for-whitelist channel, with the apply button, hidden from whoever is already approved;
- the #whitelist-review channel, where applications arrive (at first only administrators see it);
- a short form: name, age, why they want to join, how they found you and accepting the rules.
After that, two things are left that only you decide on Discord: which channels are only for the Approved role and which staff roles see #whitelist-review.
The Undo link deletes what the bot created, except channels with messages and roles that were already given to someone. The form only goes back to empty if you haven't changed it.
1. Form
Build the questions the applicant answers. Available types:
| Type | Use |
|---|---|
| Short text, Long text, Number | free answer |
| Single choice (options visible or list), Multiple choice | pick from options you define |
| Confirmation (consent) | "I have read and accept the rules" |
| Text block | a text to read, with no answer |
A choice question needs options. While any question is incomplete, the dashboard doesn't save and shows at the top which question needs fixing, with the Show button.
On choice questions you can mark the correct answer (answer key). Then each application gets a score.
2. When to ask for staff approval
| Option | What happens |
|---|---|
| Always | every application goes to the staff queue; the score is shown for information only |
| Only those who pass the answer key | whoever fails is rejected right away, whoever passes goes to the queue |
| Never | the score approves or rejects on its own |
3. Panel, review and role
- Panel channel: pick the channel and click Post panel. Posting again deletes the old panel. Use a channel where members can read but not write.
- Staff review channel: where each application goes. Make it visible to staff only.
- Role given on approval: the role the bot gives to whoever is approved.
Without a review channel, the application shows up in the channel where the person clicked Apply, with the answers in plain sight. And the approved role must be below the bot's role (see the bot's role).
4. Draw, time limit and retries
- How many questions each applicant answers: draws a few from the question bank, so nobody memorizes the test. Pinned questions always show up.
- Time limit and application window: time to answer and the dates when the whitelist is open.
- Wait after rejection: how long a rejected person waits before trying again.
5. Announcements and codes
- Public announcements: optional channels where the bot announces approvals and rejections.
- Access codes: codes that let the person straight in, with no form. Useful for guests and partners.
Review and undo
In Whitelist > Applications, approve or reject each application. Staff can also decide from the card that arrives in the review channel.
To undo an approval, open the approved application and click Remove approval. The person can apply again right away, and the bot removes the approved role. Removing the approved role from the person directly on Discord has the same effect.
Common problems
- The panel doesn't post: the form needs at least one saved question. If there are unsaved changes, save first.
- Approved but the role didn't come: the bot's role is below the approved role.
- "You're already approved on this whitelist." when trying again: remove the approval as explained above.