Server Setup
Initial bot configuration, verification, and server backup and restore.
Set up Zagreus for your server with the /setup command, configure verification for new members, and create server backups for disaster recovery.
Initial Configuration
When Zagreus joins your server, use /setup to configure essential channels and roles. All settings are stored per-server in the database.
Commands
| Command | Description | Permission |
|---|---|---|
/setup view | View all current configuration (channels, roles, tier, LFG channels, gaming history) | Administrator |
/setup mod-log <channel> | Set the moderation log channel | Administrator |
/setup trade-discussion <channel> | Set the trade discussion channel | Administrator |
/setup delete-logs <channel> | Set the deletion logs channel | Administrator |
/setup health-logs <channel> | Set the health/error log channel | Administrator |
/setup lfg-channels <channels> | Set allowed LFG channels (mention channels or "all") | Administrator |
/setup roles | Configure key roles (trade rules, muted, content ban, trusted seller/buyer) | Administrator |
Invite the Bot
Add Zagreus from the invite page or dashboard. The bot requests only the permissions it needs — no Administrator.
Run /setup view
Check which settings are already configured and which need attention.
Configure Channels
Set up your mod log, trade discussion, and delete logs channels using the /setup subcommands.
Configure Roles
Use /setup roles to assign your trade-related roles. You can set multiple roles in one command.
Add Moderator Roles
Run /trade moderator-roles add <role> to grant trade moderation access to your staff.
Features that require a channel or role will be disabled until configured. The bot will not crash or error — it simply skips the feature silently.
Verification
A button-based verification system that gates new members behind a single click, optionally assigning or removing roles on verification.
Commands
| Command | Description | Permission |
|---|---|---|
/verify setup <channel> <verified-role> [unverified-role] | Post the verification button and configure roles | Administrator |
/verify disable | Disable verification and remove the button | Administrator |
How It Works
Admin configures verification
Run /verify setup with a channel and the role to grant on verification. Optionally specify an "unverified" role that gets removed when they verify.
Bot posts a button
An embed with a "Verify" button appears in the chosen channel.
Member clicks Verify
The member receives the verified role. If an unverified role was configured, it is removed.
The bot's role must be higher than both the verified and unverified roles in the role hierarchy for assignment to work.
Server Backup
Snapshot your server's channels and roles for disaster recovery. Restores recreate only missing items — existing channels and roles are not modified.
Commands
| Command | Description | Permission |
|---|---|---|
/backup create | Take a snapshot of all channels, roles, and permissions | Administrator |
/backup info | View details of the latest snapshot (channel count, role count, timestamp) | Administrator |
/backup restore | Recreate missing channels and roles from the latest snapshot | Administrator |
What's Captured
- All non-thread channels (name, type, parent category, position)
- All roles except @everyone (name, color, permissions, position, hoist, mentionable)
- Server name and member count at snapshot time
Restore Behavior
- Only recreates items that no longer exist (by name matching)
- Rate-limited to avoid Discord API limits (pauses after every 5 creations)
- Reports how many channels and roles were restored
Backups do not capture message content, pins, or permission overwrites on individual channels. They are designed for structural recovery after a raid or accidental deletion.