Automations

Automation Buttons are used to do repetitive actions at the press of a button. Deal cards, reset the board, and much more.

Adding Automations

To add an automation button, first switch to Edit Mode, then click Automation Button in the toolbox to add a button to the room.

The Turn Button can also be configured to run an automation when clicked.

Customizing Automations

From Edit Mode you can select an Automation Button and tap the Automation button to show the Edit Popup.

Steps

From the edit popup you can change the automation steps to change the button behavior. When the button is clicked during a game, the automation will go through the steps and run each in order one-by-one.

To add a step, scroll to the bottom and click one of the rectangle buttons. Once a step is added you can change the settings to configure the automation behavior, depending on the type of the automation step.

To reorder steps, drag the circle number icon and drop in the desired position.

Types of Steps

Modify steps like Move Objects make changes to the room. These steps have a circle icon with a number on the left side.

Read steps like Number From Objects read and process data. These steps have a square icon on the left.

Every read step creates a value. A value is a number, list, or boolean.

Conditions

Conditions can be added to skip a Modify step, or to change where a Read step value comes from.

A Condition uses a boolean value to decide what to do. Boolean values are created by, for example Compare Numbers.

Popup

Near the top of the edit automation menu you'll see a Popup option. Setting this to Show will show a popup when the player clicks the button. This has two uses:

1. Confirm the player really wants to run the automation to prevent accidental clicks. Great for sensitive buttons like a Reset Game button.
2. Ask the player questions before the automation runs. You can then use their choices in some of the automations.

• Number Questions will show a number input in the popup where the player can pick a number. The chosen number can then be used in the automation steps like changing how many cards are dealt or modifying a counter.
• Choose Objects Questions will show a list of cards/pieces in the popup and allow the player to select some of them. Selected objects can then be manipulated in the automation steps below. More details here: searching a pile of cards

Tips

• In the top-right corner of the Automation Button popup, click the arrows icon to collapse all step settings to see more steps at once. This also is great when reordering steps.
• Click the step name to enter your own description of the step. This is a great way to keep complex automations organized.