Vigil Setup Guide
Complete Command & Permission Reference
Permission Levels
- True Owner — The actual Discord server owner only
- Owner Level — True owner + /owner add users + owner role holders
- Trusted Admin — Owner level + /tadmin add users + TA role holders
- Everyone — Any server member
Utility
/ping
Shows the bot's latency in milliseconds.
Everyone
/score
Displays your server's security score (0–100) with a letter grade (A–F). Includes threat level, quarantined users, log channel status, backup state, verification gate, and Trusted Admin setup.
Owner Level
Logging
/log setchannel [channel]
Sets the channel for all security alerts and activity logs. Falls back to #vigil-logs if not configured.
Owner Level
Owner Management
/owner add [user]
Grants owner-level access (excludes whitelist management and adding/removing other owners). Requires confirmation.
True Owner
/owner remove [user]
Revokes owner-level access from a user. Requires confirmation.
True Owner
/owner list
Shows the server owner, owner role (if set), and all manually added owner-level users.
Everyone
/owner setrole [role]
Assigns a Discord role that automatically grants owner-level access to anyone holding it.
True Owner
/owner removerole
Removes the owner role assignment. Manually added users are not affected.
True Owner
Trusted Admin Management
/tadmin add [user]
Grants Trusted Admin rank — can use ban, kick, timeout, and quarantine. Requires confirmation.
Owner Level
/tadmin remove [user]
Revokes Trusted Admin rank. Requires confirmation.
Owner Level
/tadmin list
Shows the current Trusted Admin role and all manually assigned Trusted Admins.
Owner Level
/tadmin setrole [role]
Assigns a role that automatically grants Trusted Admin access to anyone holding it.
Owner Level
/tadmin removerole
Removes the Trusted Admin role assignment. Individual overrides are not affected.
Owner Level
Whitelist Management
Whitelisted users are fully exempt from all automated security actions — Vigil will never quarantine, ban, or restrict them automatically.
/whitelist add [user]
Permanently exempts a user from all automated security actions.
True Owner
/whitelist remove [user]
Removes a user from the whitelist.
True Owner
/whitelist list
Shows the whitelist role (if set) and all manually whitelisted users.
True Owner
/whitelist setrole [role]
Sets a role that automatically whitelists anyone holding it. Removing the role from a member instantly revokes their whitelist.
True Owner
/whitelist removerole
Removes the whitelist role assignment. Manually added users are not affected.
True Owner
Quarantine Management
Quarantine strips all of a user's roles, saves them, and assigns a restricted role blocking messages, reactions, and voice. Roles are fully restored on release.
/quarantine add [user]
Quarantines a user. Cannot target whitelisted users. Requires confirmation.
Trusted Admin
/quarantine remove [user]
Releases a quarantined user and restores all their saved roles. Requires confirmation.
Trusted Admin
/quarantine list
Lists all currently quarantined users with timestamps and reasons.
Trusted Admin
Moderation
All moderation commands show a confirmation prompt before acting and log the action to the log channel. Cannot be used on whitelisted users or the server owner.
/ban [user] [reason]
Permanently bans a user from the server. Reason is optional.
Trusted Admin
/kick [user] [reason]
Kicks a user from the server. They can rejoin if they have an invite. Reason is optional.
Trusted Admin
/timeout [user] [duration] [reason]
Times out a user for 1 to 40,320 minutes (up to 28 days). Reason is optional.
Trusted Admin
Backup Management
Backups capture full server structure: roles, channels (with permission overwrites), emojis, animated emojis, stickers, and server name. Each server has 5 permanent slots and 3 rolling auto backup slots.
/backup create [slot]
Saves a backup to a permanent slot numbered 1–5. If the slot already has a backup, confirms before overwriting.
Owner Level
/backup list
Shows all backup slots. Auto backups (AB1/AB2/AB3) appear at the top — AB1 is the most recent, AB3 the oldest. Permanent slots (1–5) appear below.
Owner Level
/backup load [slot]
Restores from a slot. Pass a number (1–5) or an auto label (AB1, AB2, AB3). Deletes all current channels and roles then restores. This cannot be undone. Requires confirmation.
Owner Level
Verification
/setupverify [channel] [role]
Sends a verification message with a Verify button. Members click it, receive a private 4-digit code, and submit it via a popup. On success they receive the chosen role. Codes expire after 5 minutes and the setup persists across bot restarts.
Owner Level
Auto Backup
Every midnight UTC, Vigil automatically saves a backup for every server. Keeps the last 3 days as a rolling history:
- AB1 — today's backup (most recent)
- AB2 — yesterday's backup
- AB3 — 2 days ago (oldest, deleted when next daily backup runs)