Vigil Sentry Bot
The Vigil Discord bot that automates faction channels, role sync, zone alert channels, and suggestions in your server.
What is the Sentry Bot?
The Vigil Sentry Bot is a Discord bot that connects your Discord server to the Vigil platform. Once invited, it automatically handles the Discord-side of things that Vigil can't do through webhooks alone — creating channels and roles for factions, setting up zone alert channels, syncing team access roles, and managing a community suggestions system.
The bot works silently in the background. You set things up once in the Vigil dashboard, and the bot takes care of the rest.
Inviting the bot
Before the bot can do anything in your Discord server, you need to invite it and link your Discord server to Vigil.
- Go to your server's Settings page in the Vigil dashboard
- Enter your Discord Guild ID — this is the ID of your Discord server (how to find it)
- Click Invite Bot to this Server — this opens Discord's authorisation page with the correct permissions pre-filled
- Select your server and click Authorise
Once authorised, the Vigil dashboard will show a green Bot Connected indicator next to your Discord server name. The bot is now active and will begin polling for work within 30 seconds.
The bot requires the following permissions, all of which are requested automatically during the invite flow:
| Permission | Why it's needed |
|---|---|
| Manage Channels | Creates faction categories and channels, zone alert channels |
| Manage Roles | Creates faction roles |
| Manage Webhooks | Creates webhooks on zone alert channels and faction channels for posting alerts |
| Send Messages | Posts welcome embeds in faction channels, suggestion embeds, and notifications |
| View Channel | Required to interact with channels it creates and manages |
| Manage Nicknames | Renames Discord display names to gamertags when "Rename on link" is enabled |
| Manage Guild | Fetches server information for syncing |
If any of these permissions are missing or revoked, the features that depend on them will silently fail.
Gamertag linking
Players link their Discord account to their in-game gamertag by running /link [gamertag] in your Discord server. Once linked, Vigil can associate a player's Discord identity with their in-game activity — enabling player profile pages, zone alerts, raid alerts, bounty claiming, economy features, and more.
The /link command is available in any channel by default. You can restrict it to a specific channel from your server's Vigil Sentry settings.
Vigil Sentry settings
These options are available in your server's Settings > Vigil Sentry tab:
| Option | Description |
|---|---|
| Rename on link | When enabled, the bot renames the user's Discord display name to their gamertag the moment they successfully link. Requires Manage Nicknames permission. |
| Restrict linking to a channel | Restrict the /link command to a specific Discord channel. Users who run /link in any other channel will see an error directing them to the correct one. |
| Command | Who can use it | Description |
|---|---|---|
/link [gamertag] | All members | Link a Discord account to an in-game gamertag |
Factions
When you create a faction in Vigil, the Sentry Bot automatically sets up everything that faction needs in Discord — no manual channel or role creation required.
What gets created
Within ~15 seconds of a faction being created, the bot creates:
A dedicated role
Named using the faction's tag in square brackets — e.g. [IRON]. The role is assigned the faction's configured colour.
A private category
Named after the faction — e.g. Iron Brotherhood. Access is restricted: only the faction role (and the bot) can see it. No one else can.
A #general text channel
Created inside the private category, named {tag}-general (e.g. iron-general). A welcome embed is posted automatically with links to the faction page, settings, and bank.
Keeping things in sync
If the faction's name, tag, or colour is updated in Vigil, the bot automatically updates the corresponding Discord role and channel names to match.
If a faction is deleted, the bot removes the role, category, and channels from Discord.
Faction zone alert channels
When a faction leader creates a zone alert for their faction, the bot creates a webhook on the faction's existing #general channel. Zone breach notifications for that faction are posted there automatically.
Role Sync
Role sync lets Discord roles in your server automatically grant access to your Vigil server dashboard. This means players with a specific Discord role (e.g. @Staff, @Moderator) are automatically added as Vigil team members when they log in — without you having to invite each one manually.
Setting it up
- Go to your server's Settings page in Vigil
- Under Team Access Roles, click Load Discord Roles — this fetches the current roles from your Discord server
- Select which roles should grant Vigil dashboard access
- Configure the default permissions for those members (which modules they can access, whether they can use server controls)
- Save
How it works
When a user signs in to Vigil with Discord, the bot checks whether they are a member of your Discord server and whether they have any of the configured access roles. If they do, they are automatically added to your server as a team member with the configured permissions.
If a user later loses the Discord role (e.g. they're demoted from staff), they will be removed from your Vigil team on their next login.
Role sync only runs at login time. If you want to immediately revoke access for a member, you can remove them manually from the team members list in the Vigil dashboard.
Zone Alert Channels
When a player creates a personal zone alert in Vigil, the bot automatically creates a private Discord channel for it.
What gets created
- A shared Alarms category is created in your Discord server (once, reused for all personal zones)
- A dedicated text channel named
zone-{gamertag}is created inside it - The channel is private — only the zone owner (if their Discord account is linked) and the bot can see it
- A webhook is set up on that channel so the Zone Alerts module can post breach notifications directly to it
If the zone is deleted in Vigil, the bot removes the channel from Discord automatically.
Suggestions
The Sentry Bot includes a community suggestion system that any member of your Discord server can use.
Setup (admin only)
Run /suggestion-setup in your Discord server and select the channel where suggestions should be submitted. Only suggestions posted in that channel will be accepted.
To disable suggestions, run /suggestion-setup without selecting a channel.
Submitting a suggestion
Any member can run /suggestion in the configured channel and type their suggestion (up to 1,000 characters). The bot posts it as a formatted embed with the member's display name and automatically adds 👍 and 👎 reactions so the community can vote.
The bot enforces that /suggestion can only be used in the designated channel — if someone tries to use it elsewhere, they get a private error message directing them to the right place.
| Command | Who can use it | Description |
|---|---|---|
/suggestion-setup [channel] | Server admins | Set or clear the suggestion channel |
/suggestion [text] | All members | Submit a suggestion |
Language Support
Vigil Sentry automatically responds in the language each player has set in their Discord client. No configuration is needed — the bot detects the language from the user's Discord settings and responds accordingly.
The following languages are currently supported:
| Language | Code |
|---|---|
| English | en-US, en-GB |
| German | de |
| French | fr |
| Spanish | es-ES |
| Portuguese (Brazil) | pt-BR |
| Dutch | nl |
| Polish | pl |
| Italian | it |
All other languages fall back to English automatically.
Translations were assisted by Google Translate and may not be perfect in all cases. If you spot an error in your language, please let us know through the support page and we will get it corrected.