Bot Management - Enlisting

The /enlist command lets new recruits add themselves to your regiment directly from your Discord server. It automatically records their name, starting rank, and links their Discord account.

Set a welcome message

Customize the message shown when a recruit finishes to enlist:
```
/enlistsettings welcome [your message here]
```
Assign a report channel

Set a channel where the bot will post a report each time someone enlists:
```
/enlistsettings reportchannel #channel-name
```
Assign an auto-role

Give new recruits a role automatically upon enlistment:
```
/enlistsettings role @RoleName
```
The bot’s role must be ranked higher than the role you want to assign, otherwise Discord will block the action.
check if everything is set up correctly

Run the following command to see your current enlistment settings:
```
/enlistsettings info
```
Open enlistment

Run the following command in your Discord server to allow members to use /enlist:
```
/enlistsettings open
```
To disable it again at any time:
```
/enlistsettings close
```

Before opening the enlistment, make sure that the following is respected.

While the bot doesn’t need administrator permissions, the bot must have the following permissions in the server:
- Manage Roles -> To assign the auto-role to new recruits
- Edit Nicknames -> To change the recruit’s nickname with the rank.
- Send Messages
- View Channels
The bot’s role must be higher than the auto-role you want to assign, otherwise Discord will block the action.

for exemple, if the bot is below the enlisting role for K9, it will not be able to assign the roles, nor change the name of the new recruit.

Here is 2 exemple of how ranks should look like and not look like in the Discord server’s role list:

❌ Not good:

@admin
@staff
@K9 Enlisted
@K9 Recruit
@Enlisted
@Recruit
@bot <- (if you gave the bot a "bot" role), it's too low
@regpoints <- Bot is too low

✅ Good:

Regpoints can stay below staff if you follow the logic that staff are already enlisted.

@admin
@staff
@bot <- (if you gave the bot a "bot" role), it's high enough
@regpoints <- Bot is high enough
@K9 Enlisted
@K9 Recruit
@Enlisted
@Recruit