Social & Streaming Integration
How platforms like Twitch, Kick, and YouTube can integrate with Monsuta Core for interactive gameplay.
Purpose
Social integration allows viewers and community members to interact with the game economy without being active players. This extends the game's reach beyond its installed player base and creates new funding and engagement channels.
Why this exists:
- Competitive gaming generates audiences (streamers, esports viewers)
- These audiences currently have no way to participate economically
- Monsuta Core can bridge viewer engagement to on-chain actions
- This creates new prize pool funding sources and player acquisition channels
Integration Model
┌─────────────────────────────────────────────────────────┐
│ STREAMING PLATFORM │
│ (Twitch / Kick / YouTube) │
│ │
│ ┌────────────┐ ┌─────────────┐ ┌──────────────────┐ │
│ │ Chat Bot │ │ Extension / │ │ Stream Overlay │ │
│ │ (commands) │ │ Panel │ │ (real-time data) │ │
│ └─────┬──────┘ └──────┬──────┘ └────────┬─────────┘ │
│ │ │ │ │
└────────┼────────────────┼───────────────────┼────────────┘
│ │ │
└────────────────┼───────────────────┘
│
REST API / WebSocket
│
┌──────▼──────┐
│ Game Server │
│ (Monsuta │
│ Core API) │
└──────┬──────┘
│
┌──────▼──────┐
│ Avalanche │
│ (on-chain │
│ finality) │
└─────────────┘
Feature: Chat Participation Games
What
Viewers type commands in stream chat to interact with live matches:
!predict blue— predict the winner!boost player1— contribute THC to a player's pool!join— enter a viewer queue for the next match
How It Works
- Chat bot parses commands from the stream chat API
- Bot forwards valid commands to the Game Server API
- Server tracks viewer predictions and contributions in its database
- Results are displayed on the stream overlay in real-time
- Winners receive rewards (THC or achievement NFTs) claimable on-chain
Wallet Requirement
None required to participate. Viewers interact via chat with their platform username. Rewards accumulate in an internal ledger. When a viewer wants to claim on-chain, they connect a wallet at that point.
Why this matters: Requiring a wallet before a viewer can type !predict would reduce participation by >90%. Deferred wallet connection preserves engagement.
Feature: Viewer Voting
What
Viewers vote on match conditions, rule modifications, or challenges:
- Vote on which map to play
- Vote on handicap conditions
- Vote on next opponent selection
How It Works
- Streamer initiates a vote via the extension or chat command
- Game Server API opens a poll with options
- Viewers vote via chat commands or extension UI
- Results tallied by the Game Server
- Winning option applied to the next match
On-Chain Component
Voting itself is off-chain (speed, cost). Only the outcome is optionally recorded on-chain (e.g., "community chose X map for tournament round 3").
Feature: Community-Funded Matches
What
Viewers collectively fund a prize pool for a streamer's match or tournament.
How It Works
Viewer A deposits 5 AVAX ──┐
Viewer B deposits 2 AVAX ──┼──► Prize Pool Contract
Viewer C deposits 3 AVAX ──┘ │
▼
Total: 10 AVAX locked
│
Match / Tournament
played
│
▼
Winner claims from
contract directly
- Viewers deposit AVAX into a Prize Pool Contract associated with the stream event
- Deposits are locked until the event completes
- Game server submits match results
- Winners call
claim()on the contract - Funds released per predefined split rules
Trust Model
- Viewers deposit directly to the smart contract, not to the streamer
- The streamer cannot withdraw deposited funds
- The game developer cannot redirect funds
- If the event is cancelled, depositors can reclaim
Feature: Streamer-Hosted Tournaments
What
Streamers create and run tournaments with their own branding and rules, backed by Monsuta Core's competition infrastructure.
How It Works
- Streamer creates a tournament via the Game Server API
- Parameters defined: format, entry fee, prize distribution, THC bonus
- Tournament registered on-chain (Prize Pool Contract)
- Players register via the game client
- Matches played on-stream
- Results submitted by the game server
- Rewards claimable directly from the contract
What the Streamer Controls
| Parameter | Configurable? |
|---|---|
| Tournament name/brand | Yes |
| Entry fee amount | Yes |
| Prize split ratio | Yes |
| Format (bracket, swiss) | Yes |
| Additional prize pool | Yes (direct deposit) |
What the Streamer Cannot Do
- Modify results after submission
- Withdraw prize pool funds
- Change rules mid-tournament (unless contract allows it)
Feature: On-Chain Reward Claims
What
All rewards earned through social features (predictions, contributions, participation) are claimable on-chain.
Claim Flow
Viewer participates via chat
│
▼
Reward tracked in internal ledger (off-chain)
│
▼
Viewer visits claim portal
│
▼
Connects wallet (first time only)
│
▼
Claims pending rewards
│
▼
THC / Achievement NFT minted on Avalanche
Why Deferred Claims
- No gas cost during participation
- No wallet setup friction during engagement
- Batch claiming is more gas-efficient
- Viewers who never claim still contributed to the engagement layer
Web2-to-Web3 Onboarding Path
Stage 1 Stage 2 Stage 3 Stage 4
────────────── ────────────── ────────────── ──────────────
Viewer watches Viewer types Viewer creates Viewer trades
stream chat commands wallet, claims NFTs on
earned rewards marketplace
No wallet No wallet Wallet created Full Web3
No account Platform account On-chain identity participant
only
Why this progressive path?
Forcing a wallet at Stage 1 eliminates >90% of potential participants. By allowing full engagement without a wallet, the system lets users self-select into Web3 when they're ready — after they already have rewards to claim.
API Endpoints for Integrators
| Endpoint | Method | Description |
|---|---|---|
/api/social/predict | POST | Submit a viewer prediction |
/api/social/vote | POST | Submit a viewer vote |
/api/social/fund | POST | Initiate a community funding deposit |
/api/social/tournament | POST | Create a streamer tournament |
/api/social/rewards/{user} | GET | Check pending rewards for a user |
/api/social/claim | POST | Initiate on-chain claim |
For Other Games
Any game using Monsuta Core can add social integration by:
- Running a chat bot that connects to Twitch/Kick/YouTube chat APIs
- Implementing the social API endpoints on their game server
- Deploying a Prize Pool Contract that accepts community deposits
- Building a claim portal where viewers connect wallets and claim rewards
The Monsuta Core social layer is a pattern, not a library. Each game implements the chat parsing and stream overlay suited to their platform, but the on-chain settlement and reward claim flow is shared infrastructure.