Viewer UX (Extension & Standalone Client Focus)
This document describes how viewers interact with the game (equipping items, upgrading skills, and configuring their characters) using the two primary interfaces: the Twitch Overlay Extension and the Standalone Game Client.
🧭 Interaction Channels
graph TD A[Twitch Viewer] --> B{How do they play?} B -->|Active Overlay on Twitch| C[Twitch Extension Panel / Component] B -->|Interactive Standalone Client| D[Standalone Game Client Spectator Mode] B -->|Minimal Fallback| E[Basic Chat Commands for Combat States Only]
1. The Twitch Extension Panel (Primary Interface - First-Class Citizen)
The Twitch Extension is the primary, zero-friction interactive interface. It allows viewers to fully manage their RPG progression directly on the stream video player.
- The HUD Button: A small, stylized button floats on the side of the stream.
- The Slide-Out Interface: Clicking the button opens a clean, semi-transparent RPG panel overlay.
- Character & Equip: A paper-doll gear slot system. Viewers drag/click items from their inventory to equip them.
- Skill Trees: Allocation of points to combat and profession abilities.
- Shop: Direct gold exchange for items or rooms resources.
- Why this is preferred: Completely bypasses the chat, offering a graphical, mouse-driven RPG experience without leaving Twitch.
2. Standalone Client Spectator Mode (Interactive Companion - First-Class Citizen)
For players wanting a premium gameplay experience, they launch the standalone game client on their PC alongside the stream.
- Stream Connection: Enter the streamer’s name to connect.
- Interactive Sync: The standalone client displays the streamer’s scene. The player can click directly on targets, manage their inventory on their second monitor, use skills from their hotbar, and coordinate with the stream in real-time.
- Visual Feedback: Instant local rendering, bypasses video stream compression and latency.
3. Twitch Chat Commands (Minimal Combat States Only)
Due to strict Twitch API rate limits and spam filters on Bot Whispers, chat interaction is kept strictly to simple combat state triggers. No inventory, skill management, or stats queries are supported via chat.
!join [race] [class]: Enters the stream plane.!attack [target]: Enoggles automatic combat state.!defend: Toggles defensive stance.!support <username>: Toggles support/healing target state.!goto <position>: Toggles navigation target.