Guide · Chat games · Beta

How to set up chat games on your Twitch replay channel

A step-by-step walkthrough of Chat games (beta) in your VODPilot workspace: what to prepare, how to get from the setup wizard to live games in your replay channel’s chat, and what to check when viewers get no reply.

Updated November 18, 202615 min readby Michael Ketzer

Chat games (beta) add an opt-in points game to your replay channel’s Twitch chat. Viewers type !play to join, then play commands such as !fish. This guide follows the screens in your workspace from the first draft to live games. For what chat games are and how viewers play, see Twitch chat games for your replay channel.

What you need first

Any workspace member can manage chat games. Viewers need only a Twitch account, not a VODPilot account or a subscription.

Open Chat games

Choose Chat games in the sidebar. The page carries a Beta badge and has three tabs: Games, Currency and Privacy. A bar at the top stays in view with the current status and the Save draft, Review & publish and Enable games buttons.

Everything you change stays a draft until you publish, so you can prepare the rules before your replay goes live. Without a replay account, the page says Connect a replay channel to configure games. and offers Open channel settings; rules cannot be saved until it is connected.

Run the three-step setup

On the Games tab, a Start with Fishing box appears until you first publish. Choose Set up games to open Set up chat games, and move between the steps with Continue and Back.

Step 1: Currency

Enter a Currency name of up to 30 characters. The default, fish, suits the built-in fishing game. As the field hint says: Free points with no purchase, transfer or cash-out.

Step 2: Earning

Set the Shared daily game limit: how many game plays each viewer gets per day across all your games. The default is 12, the range 1 to 1,000, and it resets at 00:00 UTC. Collection unlocks such as !cook do not count toward it. Also reward normal chatting is off by default; turned on, it gives joined viewers One silent point per five minutes, up to 12 per day. You can change both numbers later on the Currency tab.

Step 3: Viewer information

The Reply to viewers who haven’t joined is what your replay account sends when someone uses a game command or !points before typing !play. The default text is:

@{user} you haven’t joined the game yet. If you agree to the rules and privacy notice at {help}, type !play. Commands: {commands}.

Rewrite it in your channel’s voice if you like, up to 350 characters, but keep {help}: it becomes the link to your channel’s rules and privacy page. {commands} lists the commands that are switched on. A preview shows the result, and Reset to default appears once you have changed the text. Like the other direct replies (the join confirmation, !points, !privacy, cooldown and limit messages), it reaches each viewer at most once every 10 seconds; normal chat messages never trigger it.

Below the reply is a readiness checklist:

A warning does not block saving or publishing, but games cannot run until it is fixed. Choose Save setup draft. VODPilot confirms Draft saved. Published rules have not changed. Nothing is live in chat yet.

Adjust the games (optional)

The Games tab lists Your channel’s activities with each command, reward, cooldown and an On or Off badge. Every setup starts with three:

The built-in activities with their default settings and the default currency.
ActivityDefaultWhat it does
Fishing · !fishOn, 10-minute cooldownFive outcomes from +1 to +5 fish, about 2.5 fish per play on average.
Search · !searchOff, 10-minute cooldownFinds +1 fish (60% chance) or +3 fish (40% chance).
Cooking · !cookOff, 1-minute cooldownA collection unlock: spend 20 fish once to unlock the cosmetic “Campfire recipe”.

Choose Edit in a row to open the activity editor. It opens only for a saved draft; otherwise you see Save this draft first, then open the activity editor. All games takes you back.

Commands and aliases must be unique, and !play, !points, !privacy, !forgetme and !yes are reserved; choosing one shows a message ending in is already used or reserved for viewer controls.

Outcomes and replies

Under Possible outcomes, each play picks one outcome with a name, a Chance in percent and a points value from −100 to +100. Negative values deduct points, but a balance never drops below zero. Add outcome allows up to 10. Until the chances total exactly 100%, you see Outcome chances must add up to 100%. The line below shows the total and the average points per play, which helps you balance a game.

Under Chat response, pick an outcome in Outcome to edit and write its Response template (up to 350 characters) with the tokens {user}, {amount}, {currency}, {balance} and {item}. Fishing’s “Dinner” outcome, @{user} caught dinner! +{amount} {currency}. Balance: {balance}., reaches chat as “@mira caught dinner! +2 fish. Balance: 42.” The Chat preview shows each reply without awarding or spending points, and VODPilot asks you to shorten any template that could get too long for a Twitch chat message.

Collections

Cooking is a collection: instead of outcomes it has a Guaranteed collection unlock with a Collection item of up to 60 characters and a price from 1 to 10,000 points. Each viewer can unlock an item once. There is no chance involved: a joined viewer with enough points always gets the item, a viewer who already owns it is not charged again, the activity’s cooldown still applies, and unlocks do not count toward the daily game limit. Items are cosmetic and appear in the viewer’s !points reply.

Add your own activities

Add game adds a points game based on Fishing’s rules, and Add collection an unlock based on Cooking. The new activity is called New activity, starts switched off and gets a generated command, and VODPilot confirms Activity added to the draft. Save, then open it to customize its rules. Choose Save draft, then Edit to name it, pick a command and switch it on. A channel can have up to 20 activities. There is no button for removing one, so switch off those you no longer want.

Fine-tune the Currency tab

As everywhere else, Save draft keeps your changes and they reach your chat when you publish.

Review and publish your rules

The bar shows where your draft stands: Unsaved changes, Saved draft isn’t published yet, or Publish rules to enable games before your first publish. When the draft is ready, choose Review & publish. The Publish these rules? dialog says Your draft is saved first. Future plays use this version. Existing balances do not change. It summarizes the enabled commands, the daily limit and chat earning, and repeats the readiness checklist. Choose Publish rules.

VODPilot confirms Rules published. You can enable games when you’re ready. Each publish creates the next numbered version, and the bar shows the version that is live. Read any warnings under the confirmation:

Enable games and read the status

Publishing does not switch games on, so the badge shows Paused. Choose Enable games. The Enable games in your replay chat? dialog says Viewers in this channel will be able to join and play. Replies appear under the replay account. Confirm with Enable games, and VODPilot replies Games enabled for this replay channel. The worker picks up changes within 30 seconds. The badge then tells you whether games are actually running:

Chat games status badges and what to do about each one.
BadgeWhat it meansWhat to do
DraftNo rules have been published yet.Finish the setup, then publish.
PausedRules are published, but games are switched off.Choose Enable games.
Ready · waiting for replayGames are on, but VODPilot’s managed replay playout is not running.Use Start stream on the Dashboard.
Enabled · replay activeGames are live in your replay channel’s chat.Try a command from a viewer account.
Test stream · games stoppedThe stream is in bandwidth-test mode, which is not public.Use End test, go live on the Dashboard, or turn off Test stream in Settings → General.
Connection issueThe replay account is disconnected or lacks the chat permissions.The workspace owner uses Reconnect in the 24/7 channel row of Settings → Channels.

The badge reflects the moment the page loaded, so reload after starting or stopping the stream. To test, type !play, then !fish in the replay chat from your main account or another viewer account, not from the replay account: VODPilot ignores its own messages. Leave a few seconds between commands.

Tell viewers how to join

Nobody takes part until they type !play; normal chatting never signs anyone up. Once your rules are published, the Games tab shows a Viewer help & privacy link below your activities. It opens your channel’s public rules and privacy page in English and German, and its My game data button leads viewers to a private page where they sign in with Twitch to see, export or delete their game data. Copy the page’s address into your replay channel’s panels.

Here is a panel text you can adapt. It is only a suggestion for the default settings; change the commands and the cooldown if yours differ.

Chat games (beta): type !play in chat to join, then !fish to go fishing (once every 10 minutes). !points shows your balance in chat. Points are free and have no monetary value. Rules and privacy: [your Viewer help & privacy link]. Leave anytime with !play leave, or delete your game data with !forgetme.

To answer “how do I play?” in chat, add a command such as !games under Custom commands in Chat & commands with a shorter version and save it with Add command. Viewers can type !privacy for the rules link. Pick a name that none of your game commands or aliases use.

Replies come from your replay account as threaded replies. Game results are queued and sent about once a second; a reply that cannot be sent within a minute is dropped. With the default settings, a short exchange looks like this:

Example chat A replay channel's chat using the default Fishing game. A viewer types !play and the replay account confirms they joined, with the rules and privacy link. Another viewer types !fish and gets "@mira caught dinner! +2 fish. Balance: 42." A second !fish gets "Try !fish again in 10 minute(s)." Then !points shows "@mira: 42 fish. Collection: empty."

Example with the default settings and VODPilot’s default replies. Your channel uses its own point name, commands and replies.

Besides !play, !fish and !points, viewers can use !privacy for the rules and their data, !play leave to stop playing, and !forgetme followed by !yes within 2 minutes to delete their game account.

Pause games or change the rules

There is no switch for removing chat games entirely. Pausing stops all play, stored game accounts follow the retention periods on the Privacy tab, and closing a workspace removes its game accounts.

Privacy notes for creators

If something does not work

Nobody gets a reply

Check the status badge and reload. Games answer only in the replay channel’s chat while the managed replay is on air, and not during a bandwidth test; the Games tab then shows Games stay stopped during bandwidth-test streams. After enabling or publishing, allow up to 30 seconds for the change to reach chat. Each viewer gets at most one direct reply every 10 seconds, so leave a few seconds between test commands. Don’t test from the replay account, and remember that viewers who have not typed !play only get the join reply.

Games will not enable

Publish your rules and connect the matching replay channel before enabling games. means the rules are unpublished or the replay account needs reconnecting in the 24/7 channel row of Settings → Channels. Configure viewer sign-in before enabling games. means VODPilot still has to finish viewer sign-in for the platform; contact support@vodpilot.com.

A command clashes with Chat & commands

Publishing warns about clashes, and Chat & commands refuses a new command that matches a published game command with a message ending in belongs to Chat games. Rename it there first. Rename one of the two; for !play, !points, !privacy, !forgetme or !yes, change the one in Chat & commands, because those names are reserved for chat games.

Viewers hit cooldowns or the daily limit

“Try !fish again in 10 minute(s).” means the viewer’s cooldown for that activity is still running. You reached the shared daily game allowance. It resets at 00:00 UTC. means they have used up the daily game limit. Adjust the activity’s Cooldown or the Daily game limit, then publish.

Review & publish is unavailable or shows an error

The button is unavailable when there is nothing new to publish or no replay channel is connected. A message below the bar names the first problem in your draft, such as chances that do not add up to 100% or a reply without {help}: Keep {help} in the reply so viewers always get the rules and privacy link.

A viewer wants their data deleted or a balance fixed

Point them to !forgetme and then !yes within 2 minutes, or to the private data page via !privacy. You cannot change balances or delete viewer data from your workspace; VODPilot support handles individual records and balance corrections at support@vodpilot.com.