OVERSEER DOCS

Twitch Integration

Twitch tracking and stream-chat XP are available from the Starter plan. Enable your trial with /trial to get started.

The Overseer connects your Discord community directly to Twitch. When members link their accounts, the bot monitors their streams, announces go-lives in rank-specific channels, tracks who's watching, and awards XP to viewers who chat during the stream.

Linking Accounts

Each member links their own Twitch account with one command:

/linktwitch [twitch_username]
Link Your Twitch Account prompt with a one-time, 10-minute OAuth link
/linktwitch — a personal, single-use OAuth link that expires in 10 minutes.

Moderators can link accounts on behalf of members who aren't currently in Discord (e.g., members who joined through Twitch first):

/manuallink twitch_username:[name] user:@Member
Use /linked to see all members who have linked Twitch accounts, and /listchannels to see which Twitch channels are currently being tracked.
Linked members embed listing Discord members and their linked Twitch usernames
/linked — every member who has connected a Twitch account.

Aliases (Alt Accounts)

Members who stream on multiple Twitch accounts can link additional channels as aliases. Stream-chat XP and attendance tracking applies regardless of which channel is live.

/addalias alias:[alt_channel] main:[primary_channel]

Go-Live Announcements

When a linked member goes live, the bot posts an announcement in the channel matching their Discord rank. Set up rank-specific channels in your config:

RankChannel Config Key
Diamonddiamond_live_channel
Goldgold_live_channel
Silversilver_live_channel
Bronzebronze_live_channel
Non-affiliate / Unrankedlive_announcements_channel

Configure channels via /setup channels or through the dashboard. You can set all five to the same channel if you prefer a single announcement feed.

The announcement itself is a plain pinged message (not an embed), with the emoji and ping target varying by rank and affiliate status:

Go-live announcement pinging @everyone with a fire emoji for a Diamond-rank streamer
Diamond rank — @everyone ping, 🔥.
Go-live announcement pinging the Hype Squad role with a sparkle emoji for a Gold-rank affiliate streamer
Gold/Silver affiliate — Hype Squad role ping, ✨.

On the dashboard, the same page also lets you pick exactly which linked members are eligible for go-live announcements at all:

Dashboard panel for selecting which linked members get go-live announcements
Who Gets Go-Live Announcements — the same list you edit with /livestreamers in Discord.

Stream Chat XP

While a member is live, the bot joins their Twitch chat and monitors messages. Members in your Discord who are chatting in the stream earn XP scaled by the streamer's rank:

Streamer RankXP per Chat Message
Bronze5 XP
Silver10 XP
Gold25 XP
Diamond50 XP
Non-affiliate streamers receive a 2× stream-chat XP multiplier, encouraging your community to support newer creators.

Stream Recaps

When a tracked stream ends, the bot posts a real recap embed to your configured stream recap channel, pinging the streamer directly. Each recap includes:

  • Stream uptime and peak / average viewer counts
  • Every Discord member who chatted — with message count, any bits/subs they gave, and XP earned
  • Lurkers who were present but didn't chat (still earn XP)
  • A Cheers & Subs field for members who cheered bits or subbed but didn't chat
  • A Raided By field crediting anyone who raided in with viewers
Stream End XP Recap embed showing chatters with message counts and XP, lurkers, and cheers & subs
The real Stream End XP Recap embed, posted automatically when a tracked stream ends.

Bits and subs only appear next to a name when applicable — no empty placeholder is shown if the member didn't cheer or sub.

Enable recaps in the dashboard under Twitch → Twitch Tracking → Stream end recap, and set the target channel under Channels → Stream Recaps.

Subscriber & Bits XP

You can reward members with XP for supporting the streamer financially. Both are optional and off by default — enable them in the dashboard under Twitch → Supporter XP.

SettingDefaultDescription
Sub XP (toggle)OffAward XP when a member subscribes or re-subs during a tracked stream
XP per subscription500 XPXP awarded per sub / resub at stream end
Bits XP (toggle)OffAward XP when a member cheers bits during a tracked stream
XP per 100 bits10 XPXP awarded per 100 bits cheered (e.g. 500 bits = 50 XP at default)
Sub and bits XP are both awarded at stream end and appear as separate XP events in the member's log — they do not replace chat XP.

Subscriber Role

You can automatically assign a Discord role to members who subscribe to a streamer's Twitch channel. This requires the streamer to connect their Twitch account with OAuth so the bot can verify subscriber status.

Sub-Role assignment is a Premium feature.
  1. 1

    Configure the sub role

    Set which Discord role gets assigned to subscribers: /setup subrole role:@SubscriberRole
  2. 2

    Connect the streamer's Twitch

    The server owner or streamer runs /connectsubs and completes the Twitch OAuth flow to grant subscriber-list access.
    Connect Your Twitch Subscriptions prompt explaining the read-only OAuth scope requested
    /connectsubs — read-only access to your subscriber list only. Nothing is ever posted or changed.
  3. 3

    Sync subscriber roles

    Run /verifysubs to do an immediate sync. The bot also checks automatically when members link their Twitch accounts.

Spotlight

A spotlight is a focused promotion event where admins highlight one streamer at a time. The bot generates an AI hype message, posts the stream link to your spotlight channel, monitors who attends, and awards XP at the end.

/spotlight user:@Streamer
/stopspotlight

Configure spotlight duration, message interval, and XP multipliers via /setup spotlight.

Commands Reference

CommandDescription
/linktwitchLink your Discord account to your Twitch username.
/addaliasAdd a Twitch alt/alias to your main linked account.
/linkedShow all Discord members with linked Twitch accounts.
/listchannelsList all Twitch channels currently being tracked.
/manuallinkManually link a Discord user to a Twitch account.
/unlinkUnlink a Discord user from their Twitch account.
/spotlightStart a spotlight for a member.
/stopspotlightEnd the current spotlight early.
/connectsubsConnect streamer's Twitch for subscriber verification.
/verifysubsSync subscriber roles against current Twitch subscribers.