Live gameplay event triggers run a playlist automatically when something happens in the match, such as a card, a substitution or a milestone. They fire from live scoring, either in LiveScore or from an external data provider. Priority decides which playlist wins when two trigger at the same time.
Overview
You'll use live gameplay event triggers when:
You want a graphic to appear automatically when a yellow or red card is shown.
You want a substitution graphic to play when a player change is logged.
You want a milestone playlist to fire every Nth time something happens for a team, for example every third yellow card.
You need to control which graphic wins when two events happen close together.
Event triggers live in the In Game (Live) tab of your game plan. For a full list of trigger events, see Live triggers: events, milestones and time.
Before you start
An Automated Game Plan for your theme. Automation needs the Graphics module. See Create an Automated Game Plan.
A Default playlist with your scorebug in the In Game (Live) tab. On Rive themes, in-play automation needs a default scorebug to work. See The Default playlist: your scorebug during play.
Live scoring for the match, from LiveScore or an external data provider. Event triggers fire from that data.
How to Set Up Card Event Triggers
Open your game plan in the Automation tab and go to the In Game (Live) tab.
Create a playlist for cards, for example "Cards".
In Configure, click Add Live Trigger and choose Yellow Card from the Trigger event dropdown. Add a second trigger for Red Card. One playlist can have several triggers.
If you want a different graphic for a second yellow, create a separate playlist with the Second Yellow Card trigger.
Add the items. A typical build is: Hide all except scorebug, then the scorebug with the card event shown as an Update, then back to the scorebug.
Event graphics take the incoming fact through their Event variable, so the player and team fill in automatically. For full builds, see Setting up card and substitution playlists.
How to Configure Substitution Playlists
In the In Game (Live) tab, create a playlist and add a live trigger with the Substitution event.
Add Hide all except scorebug, then your substitution graphic. Its Event variable fills in the player and team from the substitution that was logged.
Set the graphic's start time and duration. Event graphics look best on screen for 8 to 10 seconds.
Finish with Show scorebug so the scorebug comes back.
How to Set Up Milestone Triggers
Milestone triggers fire every Nth time something happens for a team. Examples are every third yellow card, every three corners or every five shots on target. They help mix things up, such as showing a team stats lower third every few corners.
Create a playlist in the In Game (Live) tab and add a milestone trigger with the count you want.
Add Hide all except scorebug, then a summary graphic such as a team stats or cards lower third set to Update, then back to the scorebug.
Give it a lower priority than your goal and card playlists.
For more detail, see Using milestone triggers.
How to Configure the Priority System
When two playlists trigger together, the higher priority one wins. It can also take over a playlist that is already running.
Open the playlist's Configure panel and click Show Advanced Options.
Set the priority. 1 is the highest, 4 is the lowest and 2 is the default.
A typical setup is goals highest, cards high, milestone and stats graphics lower, and time-triggered sponsor playlists at 4.
Add guards if needed. Guards are conditions that must be true for the playlist to run, for example isLive and isNotPenaltyShootout.
How to Test Event Automation
Use Preview to play a playlist with graphics over the vision and check the timing. See Preview a playlist.
Use Review Match to load a snapshot of a real match by match ID. It shows Now Playing and which trigger fired. Step through with Prev and Next, filter by Facts, Period, Timed or Milestone, and play at up to 60 times normal speed. See Review a match against your game plan.
Look for events that happen close together, such as a goal straight after a card, and check that the right playlist wins.
On match day, switch Manual off in the Control Room so the game plan runs the graphics automatically.
Tips
End every live playlist with Show scorebug or Hide all except scorebug. The app warns you if a live playlist doesn't return to the scorebug.
Keep event graphics on screen for 8 to 10 seconds.
Leave about 2 seconds between items so animations finish cleanly, and give every item its own start second.
A Hide all placed exactly on an item's end time can cut its out-animation short.
For more, see Playlist warnings and timing tips.