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.
Quick Setup starts with a feature picker, each feature tagged with the plan it needs
Quick Setup starts by asking which features you want, each tagged with its plan. It then walks you through only the roles and channels those features need. A session times out after 30 idle minutes.

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 plan covers XP, leaderboards, ranks, and birthdays. Twitch tracking and trivia start on Starter, spotlights and branding on Premium, and raid trains, AI features, anti-raid, and the public API on Ultimate. Start a 14-day free trial of everything — no card required:

/trial

Free

$0

  • ✓ XP System & Leveling
  • ✓ Manual XP Management
  • ✓ Leaderboard
  • ✓ 3 Rank Roles + Starting Role
  • ✓ Auto Role Assignment
  • ✓ Voice Channel XP
  • ✓ Birthday Announcements
  • ✓ 1 Sticky Message

Starter

$4.99/mo

  • ✓ Everything in Free
  • ✓ Twitch Integration
  • ✓ Stream Chat XP
  • ✓ 5 Rank Roles
  • ✓ Live Notifications for up to 5 Streamers
  • ✓ 1 Trivia Question a Day
  • ✓ 3 Sticky Messages

Premium

$9.99/mo

  • ✓ Everything in Starter
  • ✓ Unlimited Rank Roles
  • ✓ Live Notifications for up to 250 Streamers
  • ✓ Streamer Spotlight
  • ✓ 4 Trivia Questions a Day
  • ✓ Anti-Spam Protection
  • ✓ XP Decay System
  • ✓ Custom Branding
  • ✓ Chess System
  • ✓ Staff Scheduling
  • ✓ Outgoing Webhooks
  • ✓ Kick & YouTube Tracking
  • ✓ Twitch Subscriber Roles
  • ✓ 10 Sticky Messages

Ultimate

$19.99/mo

  • ✓ Everything in Premium
  • ✓ Unlimited Live-Notification Streamers
  • ✓ AI-Written Posts & Replies
  • ✓ AI Personality
  • ✓ Automated Spotlight
  • ✓ AI Trivia & Custom Categories
  • ✓ Raid Train Management
  • ✓ Tournaments & iRacing
  • ✓ Anti-Raid Protection
  • ✓ Public API (leaderboard & ranks for your website)
  • ✓ Unlimited Sticky Messages with Embed Styling

Lost in the settings? Run /help anywhere in your server for a topic picker covering every feature.

The Overseer's help menu embed with topic categories for every feature
/help — a full topic picker if you ever need a reminder of what's configurable.

5. Next Steps