Play Modes

4 min read

Tip

Machinations diagrams are dynamic. The models you design can be played in three ways: Play, Step and Forecast.

This is the play bar at the bottom of the editor. Press Play to watch the diagram unfold; the number and unit next to it set how many steps a Play lasts, the step button advances one step, the speed control sets how fast it plays, and the circular arrow resets. Forecast plays the diagram many times; the number beside it is how many.

The play bar: Play, number of steps, step button, speed, reset with progress, and Forecast with number of plays.The play bar: Play, number of steps, step button, speed, reset with progress, and Forecast with number of plays.

Steps and Speed

The play bar has three small menus that set how long a Play lasts and how fast it plays.

Steps: the number next to Play is how many steps one Play lasts. Choose 10, 12, 20, 50 or 100, or type your own number from 1 to 9999 in the Custom box. All Nodes on a diagram change their state synchronously during one Step.

The Steps per play menu with 10, 12, 20, 50, 100 and a Custom box from 1 to 9999.

1 Step = 1 player action OR
1 Step = 1 core loop OR
1 Step = 1 game played

The word after the number (here steps) is the name of the unit, and you can rename it: Step, Turn, Round or Epoch, or a time unit such as Year, Quarter, Month or Day, or your own name in the Custom box.

The Rename step unit menu with Step, Turn, Round, Epoch, Year, Quarter, Month, Day and a Custom box.The Rename step unit menu with Step, Turn, Round, Epoch, Year, Quarter, Month, Day and a Custom box.

The small arrow on the Play button renames the Play itself: Play, Game, Season, Cohort, Campaign, Journey, Cycle or Experiment, or your own name.

The Rename Play unit menu with Play, Game, Season, Cohort, Campaign, Journey, Cycle, Experiment and a Custom box.

Speed: the speed button sets how fast the diagram plays: 0.25×, 0.5×, 1× (the default), 2× or 4×. The speed is your own: the number of steps is shared with everyone who opens the diagram, but the speed you choose changes only your own view.

The Speed menu with 0.25x, 0.5x, 1x, 2x and 4x.

Available Play Modes

Step

The step button The step button of the play bar.The step button of the play bar., next to the number of steps, advances the diagram one step at a time. This is an easy way to debug your diagram as you build it and identify where it breaks.

Interactive Play

Press Play The Play button with its small menu arrow.The Play button with its small menu arrow. to watch the diagram play step by step as it is drawn, for the number of steps you chose. Press it again to pause; the button then says Resume. The bar shows how far the Play has got, for example 7/20 steps, and the circular arrow resets it. This is the only mode that supports On click Nodes and real-time changes on the diagram while it plays. While the AI Agent is writing the model, Play, Step and Forecast wait until it has finished.

Forecast

The Forecast button with the number of plays and the word plays.The Forecast button with the number of plays and the word plays.
The Forecast button and the number of plays

Forecast plays the diagram many times in a row, and the number beside the button (5× in the picture) is how many plays. On click Nodes never fire in a Forecast.

Note

When a Forecast finishes, the app shows a notice that says Forecast finished. The cards under the canvas then summarize the plays, for example how many plays reached the last step and the median value of each node. Each card also shows its Precision (Rough, Fair, Good or Sharp: Fair is within ±20%, Good within ±10% and Sharp within ±5%) and how many more plays would raise it; the menu beside Forecast lists the ranks you can reach (for example Good), and choosing one plays just enough Plays to get there, then stops. Open a card to see the Fan chart or the Line chart and a table of statistics: max, p99, p95, median, mean, p5 and min.

Remember to save your progress before switching diagrams.

Two result cards after a Forecast: Forecast summary showing how many plays reached step 20, and a Gold card showing the median.Two result cards after a Forecast: Forecast summary showing how many plays reached step 20, and a Gold card showing the median.
Forecast result cards
Tip

Steps and Forecasts work together.

Use the number of Steps to determine how many days/actions/games one Play lasts. Then set how many plays a Forecast makes to get statistically relevant results.

Scenarios. Mark Pools, Registers and connections as Levers (right-click a component, use the Lever switch in the Properties panel, or press Cmd+Shift+2 on a Mac, Ctrl+Shift+2 on Windows), then open the Scenarios tab in the header to move them and compare the Outcomes. Moving a Lever adds a scenario to the list and plays it once. Try other Lever values plays one Forecast for each setting of a Lever and ranks the Levers under Which Lever matters most? A Lever moved during a Play takes effect from the next Play.