A UI guide to Machinations

New to Machinations? Start from the beginning: get an interface rundown in less than 3 minutes!

Watch the video, or read all about it below.

Your Machinations Workspace is where you’ll create your game designs, set parameters, run simulations and plot results. This Tutorial walks you through of the interface.

Top Menu

In the top menu you will find everything you could expect from a Docs suite. A particularity is File > New from Template. This should be interesting for both beginner and advanced users: it’s here where you can find the templates we make public. It’s a perfect place to start, because you can quickly access a ready-built diagram and play around to see how it works… It’s a nice way of getting over the empty canvas block every one of us may experience.

Machinations & Library Panel

Split into 3 sections:

  1. Machinations - where you can access all Nodes and Connections. You can drag and drop them onto the canvas, or double click them to be automatically placed.

  2. Library - the sections in which you'll find public, ready-made systems to get you started. Just drag and drop them onto the Canvas.

  3. My Library - to this section, you can systems for easy drag and drop access. Select the nodes and connections you’d like added, open the contextual menu and select Insert into My Library (see below).

Diagram Panel

Is where you can change the settings of your Diagrams.

Under Functional, you can change the functional settings of the whole Diagram, and those of each of the Nodes and Connections you placed on the canvas.

In Page Set-Up you can tinker with the canvas’ appearance: turn off the Grid or maybe apply a background image.

Top bar

Once you have a system diagrammed, in the top bar you can find the Types of Runs you want to perform on the system: be it an Interactive, a QuickRun or a Multiple Run. Plus, the standard buttons to represent each of the actions you can perform: play the diagram, pause it, stop it, or run it step by step.

Execution Chart

In the bottom of the Canvas, you cam reveal the Execution Chart of your diagram, by dragging its edge upwards.

Add the Nodes you want to plot by right clicking them, and selecting “Show in Chart”. When you run your diagram, the Chart will start plotting these values.


  1. The Top Menu has all the typical drop-downs you could expect from a Docs suite - most important being New from Template;

  2. The Machinations & Library Panel to access all Nodes, Connection, and small system parts saved either by you in My Library, or by us in Library;

  3. The Diagram Menu to access diagram settings, be them for functional or appearance changes;

  4. The Top Bar from where you can run your diagram;

  5. The Execution Chart where you can log the execution values of your simulations.