OVERSEER DOCS

Getting Started

This guide walks you through inviting The Overseer, running the setup wizard, and enabling your first features. Most servers are fully configured in under 10 minutes.

1. Invite the Bot

Go to mavops.org/overseer and click Add to Server. Select your Discord server from the dropdown, then approve the requested permissions. The bot needs:

  • Read & Send Messages
  • Embed Links
  • Manage Roles (for rank promotions)
  • Manage Channels (optional, for Private VCs)
  • Moderate Members (for Anti-Raid actions)
Grant Administrator during initial setup if you want the bot to create channels automatically. You can tighten permissions after setup is complete.

2. Run the Quick Setup Wizard

The fastest path to a working configuration is the guided wizard. Run it as a server admin in any channel:

/quicksetup

The wizard walks you through five steps:

  1. 1

    Roles

    Point the bot to your existing rank roles (Unranked, Bronze, Silver, Gold, Diamond) or let it create them for you.
  2. 2

    Channels

    Select or auto-create channels: welcome, rules, spotlight, trivia, birthday, go-live announcements, stream recaps, rank-up announcements.
  3. 3

    Feature Selection

    Toggle which features you want active: XP system, Twitch integration, Spotlights, Trivia, Raid Train, and more.
  4. 4

    Branding

    Set a custom bot name, community name, theme, member title, and catchphrase. These appear in bot embeds across your server. Premium
  5. 5

    Feature-Specific Channels

    Assign dedicated channels for trivia questions, spotlight announcements, and rank-split go-live pings (Bronze / Silver / Gold / Diamond).
You can revisit any setting at any time with /setup view to see the current config, or individual /setup <section> commands to update specific options.

3. Link Twitch Accounts

Members link their own Twitch accounts with a single command:

/linktwitch [username]

Once linked, the bot tracks when that member goes live on Twitch and posts announcements to the configured go-live channel based on their Discord rank.

Members who stream while others watch and chat in their Twitch chat earn stream-chat XP for their viewers automatically — no extra setup needed once accounts are linked.

4. Enable Your Trial

The Overseer's free tier covers XP, leaderboards, trivia, and chess tournaments. Twitch tracking, spotlights, raid trains, and branding are Premium features. Start a 14-day free trial — no card required:

/trial

Free

$0

  • XP & Leveling
  • Leaderboards
  • AI Trivia
  • Chess Tournaments
  • Reaction Roles
  • Birthday System

Premium

$19.99/mo

  • Everything in Free
  • Twitch Integration
  • Stream Chat XP
  • Spotlights
  • Custom Branding
  • Anti-Raid
  • XP Decay
  • Raid Train
  • Staff Schedule
  • Race Control

5. Next Steps