Automations and Scenes

This is where a room comes to life. Automations react on their own — an objective is solved, the timer hits a moment, a device changes — and do something: release a lock, drop the lights, play a sting, send a warning. Scenes are the same kind of actions packaged as a sequence you run on demand, and Quick Actions put those one tap away on the control page.

All three are scoped to one game: they’re only active while that game runs, and they can read and write that game’s variables and constants and drive its devices and displays. You build them in the Editor — open the game and go to the Logic tab, which holds four sub-tabs: Automations, Scenes, Variables, and Constants.

Automations: the three columns

Every automation reads as one sentence: when something happens, if the room is in the right state, do these things. The builder lays that sentence out as three columns.

• When — the triggers, the events that can start the rule. You need at least one.
• If — the conditions, optional checks that must pass for the actions to run.
• Do — the actions, the steps ARC runs, top to bottom.

If you add more than one trigger, you can choose whether any trigger starts the rule or all of them must have happened. Most rules use a single trigger.

When — triggers

A trigger is the event ARC watches for. Pick the one that matches the moment you care about.

If — conditions

Conditions are optional. They let an automation run only when the room is in the right state. With none, the actions always run when the trigger fires. The core checks are:

• Device — check a device’s current value (for example, “only if the room lights are on”).
• Variable — check a saved variable’s current value, with rich comparisons: equals, not equals, greater than, less than, contains, starts with, is one of a set, list contains, and more.

You can combine checks into groups:

• All (AND) — every check inside must be true.
• Any (OR) — at least one check inside must be true.
• Not — the check inside must be false.

Groups can hold other groups, so you can build “if the door is closed and (the code is correct or staff overrode it).”

Do — actions

Actions are the steps ARC runs, in order, from the top of the Do column down. ARC groups them in the action picker so they’re easy to find.

Devices

• Device action — call a named action exposed by a device (turn a relay on, open a lock, set a light).

Game and session

• Objective action — complete, reset, or bypass an objective.
• Hint action — send a configured objective hint.
• Game action — control game state, adjust time, or call a game-level action.
• Variable — set, adjust, toggle, or reset a game variable.
• Display message — send a message to one or more displays.

Audio and video

• Audio — play sounds, control ambient audio, stop playback, or set volume.
• Video — play a fullscreen video overlay on a display.

Displays

• Display actions — push text, change a layer, set a background, or clear display content on chosen displays.

Moments (Vision add-on)

• Capture photos / Capture clip — grab photos or a short video clip from a room camera into this session’s Moments, so staff can hand a group their best moment afterwards.

Flow and links

• Automation action — enable, disable, or stop a different automation.
• Scene — run a scene’s action sequence.
• Wait — pause for a set time before the next action.
• If / Choose / Repeat — branch on a condition, branch on which trigger fired, or repeat a run of actions.

Integrations

• Publish MQTT message — send a message to an MQTT topic for other systems to pick up.

Run: once, or every time

A game automation has one behavior choice, labeled Run:

• Every time — the automation runs whenever its trigger matches.
• Once per game — after it runs once, it won’t run again until the game is reset.

“Once per game” is perfect for a sequence that should only ever play one time in a session, like the win celebration.

Test

You don’t have to start a real game to check your work. Use Test to fire the automation on demand and watch what happens. It shows live status as it goes — Starting, Queued, Running, Waiting, and finally Finished or Failed — along with an activity log of each action. If a step fails, the log tells you which one and why.

If the conditions in the If column aren’t met, the run reports Didn’t run — conditions weren’t met and offers Run anyway so you can still test the actions.

Build one: lights drop when the final puzzle is solved

A complete game automation, start to finish.

1. On the game's Logic tab, under Automations, create a new automation and name it clearly, like "Finale — drop the lights."
2. In the When column, add an Objective trigger. Pick your final objective and set the status to completed.
3. In the If column, optionally add a Device condition so the rule only runs when it should — for example, only if the room lights are currently on. (Skip this column to always run the actions.)
4. In the Do column, add a Device action that turns the room lights off.
5. Add a Wait of 2 seconds, then an Audio action set to Play sound that plays your victory sting on the room display.
6. Set Run to Once per game so the finale plays one time.
7. Press Test and watch the activity log. When it reads Finished and the lights and sound behave, save.

Starter recipes

You don’t always have to build from a blank rule. When you create a game automation, ARC offers presets to start from — common patterns like Lock Release on Solve, Time Warning, DMX Blackout on Timer End, Hue Scene on Game Start, All Objectives → Success, and Game Reset → Reset Devices. A preset fills in the shape of the rule; you still point it at your own devices, objectives, and media, then test it.

Scenes

A scene is an action-only sequence. It has a Do list — the same actions you use in automations above — but no trigger and no conditions. A scene never fires on its own. It runs only when something asks it to:

• a staff member runs it from a Quick Action button on the control page,
• an automation runs it with a Scene action, or
• you press Test while building it.

Because a scene is just a reusable list of steps, it’s the natural place for any sequence you want to fire the same way from several spots — a “reset the props” routine, a “house lights up” cue, or a “play the intro” sequence you trigger both automatically and by hand.

Quick Actions

A Quick Action is a one-tap button on the control page that runs a scene or an automation. Quick Actions live in the Quick Actions panel of the control page, so staff can fire a cue without digging through menus mid-game.

You set a Quick Action up in the Editor, on the automation or scene you want the button to run. Each button can be tailored:

• Button label — the text on the button (for example, “House Lights” or “Replay Intro”).
• Color — the button color, so important or destructive actions stand out.
• Require confirmation — turn this on and the button stages on the first press and only runs on a second press, guarding against an accidental tap.
• Match button color to state — for a button that turns something on or off, ARC colors it by the current state: green for the on value, red for the off value, so staff can see the room’s state at a glance.
• Custom tooltip — extra context on hover, so the button itself can keep a short name.
• Group — put related buttons together. Groups become sections in the control page’s Quick Actions panel.

Add a Quick Action

1. In the Editor, open the scene or automation you want behind the button.
2. Turn on Enable quick action, then set a clear Button label and a Color.
3. If the action is significant — releasing a lock, ending a game — turn on Require confirmation so staff press twice before it runs.
4. If the button controls something with an on/off state, turn on Match button color to state so its color tracks that state.
5. Save, then open that game's control page and check the button appears in the Quick Actions panel and behaves as expected.

Where to go next

• Variables and constants — give your rules memory and math.
• Devices — the props an automation reacts to and controls.
• Displays and audio on the control page — where Quick Actions appear while a game runs.
• System → Logic — business-wide rules that aren’t tied to one game.