OVERSEER DOCS

Twitch Integration

Twitch tracking and stream-chat XP are Premium features. 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]

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.

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.

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 recap embed to your configured stream recap channel. Each recap includes:

  • Total stream duration and peak / average viewer counts
  • Every Discord member who chatted — with message count, XP earned, and any bits or subs they gave
  • Lurkers who were present but didn't chat
  • A Supporters section for members who cheered bits or subbed but didn't chat

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.
  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.