Stream Versus — User Guide

A short guide for hosts and opponents to start a live “battle”.

What you need

  • A Chaturbate account
  • Full Chaturbate Events API URL (e.g. https://eventsapi.chaturbate.com/events/<username>/<key>/)
  • OBS Studio or other streaming software
  • Stable internet connection

Launch steps

Step 1. Create a session

  1. Click “Create session” onstreamversus.com
  2. Paste your full Chaturbate Events API URL (for example,https://eventsapi.chaturbate.com/events/<username>/<key>/). We will detect your username and token automatically.
    No token yet? Create one here:https://ru.chaturbate.com/statsapi/authtoken/, then compose the URL likehttps://eventsapi.chaturbate.com/events/<your_username>/<your_token>/and paste it.
  3. We validate your key:
    • if the key is invalid — polling stops, the saved key is removed, and you’ll be asked to re-enter it;
    • if the key is valid — event polling starts and you become Player A in the session.
User guide: Create a Chaturbate Events API token
User guide: Copy your Chaturbate Events API key
Notes:
  • You cannot have more than one active session at a time. A new active session will automatically close your previous one.
  • We use a long-lived cookie/JWT to identify the current user within a session.

Step 2. Invite an opponent

  1. Copy the invitation link in the interface
  2. Send it to your opponent
  3. Your opponent opens the link and pastes their full Chaturbate Events API URL (same format as above)
  4. After a successful check, the opponent joins as Player B
Invariants:
  • A player is added to a session only after their key is validated
  • If the opponent’s key is invalid, the system will reject the connection and ask for a correct key

Step 3. Add window capture in OBS and go live

  1. On the desired scene click “+” in Sources → “Window Capture” or “Screen Capture”
  2. Select the browser window with the battle/chat UI (e.g. this site)
  3. Crop and resize to fit your canvas (e.g. 1920×1080) if needed
  4. Place the layer where you want it in the scene stack
  5. Start streaming

Important: do not use a “Browser Source” with the overlay URL. We capture the browser window where the chat and game progress are displayed.

Step 4. Start the battle

  1. Click “Start battle” in the control UI
  2. A timer and score will appear. Points update automatically by events (1 token = 1 point)
  3. Battle ends automatically by rules:
    • by silence (no activity)
    • by time limit
  4. Emergency stop is available for moderator/system: ends immediately without determining a winner (and this is not a draw)

Common situations and solutions

  • Invalid key:
    • the system stops polling, removes the saved key, and asks you to enter a new one
    • enter a valid key and try again
  • Lost sync (no incoming events):
    • the game flow is not paused, timers keep running
    • automatic finish is blocked until sync is restored
    • as soon as events resume, sync restores automatically
  • No signals from both players:
    • if there are no signals from both participants for 10 minutes, the session will automatically finish with status expired_no_signals
  • One active session per player:
    • starting a new active session automatically closes all your other active sessions

Security and privacy

  • The access key is used only to poll your stats and is stored locally for the current user; on access error it’s removed automatically
  • No real money goes through the system: we track stats only and convert them to points

Where to get the Chaturbate Events API URL?

  • Go tohttps://ru.chaturbate.com/statsapi/authtoken/and create an Events API URL
  • Example: https://eventsapi.chaturbate.com/events/mankeyking/2OoKeRVMlpnyfrcuvvrcvW3Z/
  • Paste this URL into the session interface field
  • If the Chaturbate UI differs, look for the statistics/API section and the Events API option. See examples in the screenshots above.

Support

  • If something doesn’t work (key is not validated, no events, overlay not visible), reload the page, check your internet, and re-enter the key
  • If the issue repeats, contact project support. Please include what you did and the time it happened

WebSocket connection

Connecting to server…