Streamer Module
Go-live alerts for Twitch, YouTube, and Kick, live status in the dashboard, and an optional streamer hub panel with social links.
Overview
The Streamer module watches linked platform accounts and posts a go-live message when someone starts streaming. You map each account to a Discord member so mentions and live roles apply correctly.
Feature toggles let you enable or disable alerts, the hub panel, streaming schedule block, live role, and clip channel independently — useful if you only want a directory panel without pings.
Plus users can customize the hub panel with a CV2 embed draft; the bot injects the live account list and controls around your design.
Setup
- Dashboard → Server → Modules → Streamer → Enable.
- Open Configure — use the status ribbon to see which features are on.
- Set Notify channel and compose the notify message (placeholders supported — preview in the editor).
- Under Watch lists, add Twitch usernames, YouTube channel IDs, and Kick usernames per platform tab.
- Under Live mappings, link each watched account to a Discord user (member picker).
- Optional: enable Hub panel, pick announce channel, add social link presets, edit hub embed draft (Plus).
- Click Update panel to post or refresh the hub message in Discord.
Key settings
- Alerts enabled — master toggle for go-live posts; requires notify channel.
- Notify message — template for the announcement; preview shows resolved placeholders.
- Live role — role assigned while live (optional); needs Manage Roles and correct hierarchy.
- Auto-ping role — role mentioned in go-live posts.
- Clip channel — optional channel for clip highlights when clips feature is enabled.
- Schedule — text block on hub panel; toggle schedule without deleting text.
- Social links — preset buttons (Twitch, YouTube, Kick, custom URLs) on the hub panel.
- Linked accounts — ties platform identity to Discord user for mentions and live role.
Watch lists & live mappings
Watch lists are raw platform identifiers the bot polls. Twitch uses login names; YouTube uses channel IDs; Kick uses usernames.
Live mappings connect each watched entry to a guild member. Without a mapping, alerts may still fire but mentions and live roles can be wrong.
The dashboard live status cards show who is currently live (cached fetch) — use Sync panel after changing hub layout.
Duplicate mappings for the same Discord user are avoided — one primary account per member is best practice.
Hub panel
The hub lives in your announce channel as a Components V2 message. It can list live streamers, your schedule text, and social buttons.
Custom panel draft (Plus) replaces the static banner area; Lio still injects dynamic live entries and required controls.
If you use a fully custom layout without bot placeholders, a warning explains that live lists may not appear — prefer the default injection points.
Usage in Discord
- Members do not run commands for alerts — going live on a linked platform triggers the notify channel post.
- Hub panel is read-only for members (links and live status).
- Staff use the dashboard to add/remove accounts and refresh the panel — not in-bot configuration.
Troubleshooting
- No go-live post → alerts enabled? notify channel set? account on watch list? mapping correct?
- Wrong mention → fix Live mapping Discord user for that platform account.
- Live role not applied → bot role above live role; Manage Roles permission.
- Hub empty or stale → Update panel; check hub panel enabled and announce channel permissions.
- YouTube not detected → use numeric channel ID, not handle URL.
- Status cards show offline but stream is live → external API delay; wait and refresh dashboard.