Skip to content

Twitch Conditions

twitch_conditions is an optional block in your workflow that adds Twitch-specific filtering and behavior on top of the standard conditions. Unlike conditions, these don't run commands — they filter based on event data directly.

twitch_conditions:
  target:
    - MakiTazo
  amount: 5

Fields

Field Type Description
target list[str] Player names in the server to apply steps to. Steps are skipped for players not online. If none are online, the workflow does nothing.
amount int bits only Only trigger if the cheered amount matches exactly.
reward_title str channel points only Only trigger if the redeemed reward title matches.
apply_tiers bool subscription only If true, repeats steps once per tier level (Tier 1 = 1x, Tier 2 = 2x, Tier 3 = 3x). Default: false.
max_viewer_multiplier int raid only Repeats steps once per viewer, capped at this value.

Placeholders

You can use these placeholders inside your steps:

  • {target} — replaced with each target player's name.
  • {user_name} — replaced with the display name of the user who triggered the event. Available for TwitchFollowEvent, TwitchBitsEvent, TwitchSubscriptionEvent, and TwitchChannelPointsEvent.

Examples

Spawn a charged creeper upon five bits donation

name: "charged creeper on bits"
event:
  - TwitchBitsEvent
twitch_conditions:
  target:
    - MakiTazo
  amount: 5
steps:
  - 'execute at {target} run summon creeper ~ ~ ~ ~ ~ minecraft:become_charged "{user_name}"'

Spawn a wither on channel point redemption

name: "wither on redemption"
event:
  - TwitchChannelPointsEvent
twitch_conditions:
  target:
    - MakiTazo
  reward_title: "Summon me a Wither"
steps:
  - 'execute at {target} run summon wither ~ ~ ~'

TNT rain upon raid

name: "raid tnt"
event:
  - TwitchRaidEvent
twitch_conditions:
  target:
    - MakiTazo
  max_viewer_multiplier: 50
steps:
  - 'execute at {target} run summon tnt ~ ~2 ~'

TNT upon tiered subscription

name: "sub tnt barrage"
event:
  - TwitchSubscriptionEvent
twitch_conditions:
  target:
    - MakiTazo
  apply_tiers: true
steps:
  - 'execute at {target} run summon tnt ~ ~5 ~' # This will execute two times if sub was Tier 2