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 with their Twitch link and removes it after the stream. In the dashboard's Live Announcements panel you choose how announcements are routed:

  • Compact — every go-live goes to one channel.
  • Group by rank — each rank posts to its own channel.

For each channel you decide whether to ping @everyone, a role, or nobody. The server owner, staff and non-affiliate streamers can each get their own channel and ping, which take priority over the rank channel (owner first, then staff, then non-affiliate). Live announcements need the Starter plan or higher, and the number of tracked streamers depends on your plan.

Dashboard Live Announcements panel: Compact or Group by rank, with ping everyone and ping role options
Live Announcements in the dashboard (Channels tab) — pick the mode, then the channel and ping for each row.

You can also pick exactly which linked members are eligible for go-live announcements at all, with /livestreamers in Discord or on the dashboard.

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.