Whitelist and department applications

What you get

Let people apply in Discord for your whitelist, police, fire, EMS or staff team. Your team reviews each application with Accept, Interview or Deny. The applicant gets a DM with your decision and reason, and accepted people get their roles automatically, for example Whitelisted or LSPD Applicant.

Pair it with the FiveM whitelist and only accepted people can join your FiveM server. Free, with Glitchworks Guard.

You'll need

• Glitchworks Guard in your Discord, with its role above the roles it should give (Server Settings > Roles: drag Glitchworks Guard up).
• The Manage Server permission.
• For the FiveM whitelist: the free Glitchworks Link resource on your FiveM server.

Part 1: Applications

Step 1: Open the setup

1. Type /applications setup.
2. In 1. Which forms are open? tick the ones you want, for example Whitelist and Police.

Step 2: Channels

1. Press Create #applications-review. This is a private channel where applications arrive. Only staff (and the reviewers you pick later) can see it.
2. Press Create #applications. This is where members press a button to apply. Guard posts the panel there.

Prefer your own channels? Pick them in the 2. and 3. menus, then press Post the panel.

Step 3: Set up each form

In 4. Change a form…, pick a form (for example Whitelist):

1. Roles to give when accepted: pick up to 3, for example Whitelisted. Don't have one? Create it in Server Settings > Roles first.
2. Who can review Optional: your staff role always can. For police applications you might add LSPD Command.
3. Edit questions Optional: every form comes with sensible questions. To change them, write one question per line:

   Your character's name and age | e.g. Sam Carter, 29
   short: Your timezone
   Anything else we should know? (optional)

   • After a | you can add a hint shown inside the box.
   • Start a line with short: for a one-line answer (otherwise it's a paragraph).
   • End with (optional) if it can be left blank.
   • Up to 5 questions per page, 3 pages. Questions can be up to 45 characters (Discord's limit).
4. Re-apply wait: how many days someone must wait after a "no" (default 7).
5. Press Back and do the next form.

Step 4: Turn it on

Press Turn on. The panel in #applications now shows a button for each form.

How members apply

They press a button on the panel (or type /apply), fill in the form and press Submit. Long forms have a Next page button. They can only have one open application per form.

How your team reviews

Each application arrives in #applications-review with the answers, how old the Discord account is, and when they joined.

• Accept: optionally type a message (for example "Welcome! Read #rules first"). Guard gives the form's roles and DMs them.
• Interview: type when and where (for example "Interview VC, Saturday 8pm UK"). Guard DMs them. Accept or Deny later, after the interview.
• Deny: type a kind reason (or leave it blank). Guard DMs it, with when they can apply again.

If their DMs are closed, Guard tells you so you can let them know.

Handy commands for staff

• /applications list: everything waiting or in interview (with links to the cards).
• /applications history @member: every application and decision for one person.

Every action is also posted in your Guard logs channel and kept in an audit log for a year.

Part 2: The FiveM whitelist

Now make the Whitelisted role the key to your FiveM server.

1. Install Glitchworks Link on your FiveM server and link it. It takes about 5 minutes.
2. In Discord: /fivem setup > Whitelist.
3. In the menu, pick the role(s) that let people in, for example Whitelisted.
   • Needs: any role means one of the roles is enough. Press it to switch to all roles.
   • Pick no roles at all, and simply being in your Discord is enough.
4. Press Invite link and message:
   • Your Discord invite link: for example https://discord.gg/yourcode. Make it never expire (Discord: Invite People > Edit invite link > Expire after: Never).
   • Message Optional: what people without the role see. Leave it blank for a friendly default that tells them to apply in your Discord and reconnect once they're accepted.
5. Press Turn on.

Test it

1. In your FiveM server console (or txAdmin's Live Console) type:

   glitchworks_link test 123456789012345678

   using your own Discord user ID. It prints ALLOWED or NOT ALLOWED and why.
2. Connect with an account that doesn't have the role: you should see your message and invite.

Your Discord user ID: in Discord, open User Settings > Advanced and turn on Developer Mode, then right-click your name and choose Copy User ID.

Don't lock yourself out

Add your staff to the bypass list in the resource's config.lua, so they can always join, even if Discord is having a bad day:

Bypass = {
    'discord:123456789012345678',
    'license:abcdef0123456789abcdef0123456789abcdef01',
},

Then type restart glitchworks_link in the server console.

Troubleshooting