Skip to main content

Interactions: The Available Actions

An Interaction answers what happens. A single Interaction can combine several actions, for example showing an alert, playing a sound, and running a Minecraft command from one trigger.

Creating an Interaction​

  1. Open the Interaction Center menu.
  2. Click the [+ Interaction] button.
  3. Fill in Enter Name. This is the name you'll pick from an Activity later, so make it clear.
  4. Tick the actions you want, then fill in their fields.
  5. Save.

Creating a new Interaction in the Interaction Center

The action list​

Displayed on an overlay​

These actions need a Screen and only show up if the overlay is installed.

ActionWhat it does
Show ImageDisplays an image you upload
Play Video FilePlays a video file
Play AudioPlays a sound (pick one of the available sounds or upload your own)
Show Alert (User + Text)Shows the viewer's profile photo with text. The Text Format field accepts message variables
Read Text (TTS)Reads text aloud in a Google voice. The Voice Format field, for example: Hello {username}!

Driving other things​

ActionWhat it doesNote
Trigger Stream AvatarRuns an avatar animation on screenOptions: Jump Animation, Run Animation, Drop Bomb, Summon Nuclear
Execute Minecraft CommandSends a command to your Minecraft serverRequires a Minecraft connection
Trigger WebhookSends data to your own URLThe link must start with http:// or https://
Simulate KeystrokesPresses keyboard keys into a game or appDesktop app only
Switch OBS SceneChanges the scene in OBSRequires an OBS connection
Activate OBS SourceTurns on a source in OBSTurned off again automatically when the Interaction's duration ends
Change Win/Lose PointsAdds to or subtracts from the Win/Lose Bar scoreEffects: Add WIN, Subtract WIN, Add LOSE, Subtract LOSE, Reset both scores to 0
Spin the RouletteSpins the Spin Roulette wheel
Trigger Webhook sends POST, not GET

IndoFinity's webhook sends data as POST FormData. Older documentation said it used GET, which no longer applies. Make sure your endpoint accepts POST.

Simulate Keystrokes needs the desktop app

A browser can't press keyboard keys outside itself. This action only works through the IndoFinity desktop app. In a browser it is ignored.

Important settings​

SettingWhat it doesNote
Media VolumeSets the volumeAffects Play Audio and Read Text (TTS)
How many seconds will it appear?How long the action stays on the overlayOnly matters if you don't add Audio or TTS. If you do, the duration follows the length of the sound
Select ScreenThe Screen this action appears onOnly used by Show Image, Play Audio, Play Video File, Show Alert, and TTS
Repeat as many times as the gift comboThe action starts as soon as the combo begins and repeats once for each gift in the comboIf unchecked, the action runs once after the combo ends, so there's a delay while it waits for the combo to finish
Cut short if another action is queuedThis action shows for only 1 second if another action is waiting in the queueUseful on busy lives
Fade in/out transitionSounds, images, and videos fade in and out smoothly
Tip

People misunderstand Repeat as many times as the gift combo more than any other setting. If your gift alerts feel "late", it's usually because this box is unchecked. The system waits for the viewer's combo to finish before it runs the action.

Testing an Interaction​

The Play Interaction button in the table runs that action right away, with no Activity and no live needed. It's the fastest way to check that your overlay and Screen are set up correctly.

Common problems​

Symptom: an Interaction is marked "not active". The message reads: "This interaction is not active. Please renew your premium or delete this interaction." You've gone over the free account limit. See Free Limits and Add-ons.

Symptom: a Screen offline warning appears. That Screen's overlay isn't installed in OBS yet. Copy its link and install it. Installing Overlays shows how.

Symptom: a conflict warning on a "user join" action. Actions triggered by viewers joining run very often. If such an action shares a Screen with other overlay actions, those can be delayed or dropped. Move the user join action to its own Screen.

See also​