Interface Basics

Get started 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 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:

  • 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.

  • 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 Add to My Library (see below).

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

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.

📖 Read about Time Intervals and Time Steps.

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

Top bar

Types of Runs (simulations)

Once you have a system diagrammed, in the top bar you can find the Types of Runs you want to perform on the system: Run, Step-by-Step Run, QuickRun or MultipleRun.


Use Tags to categorise and manage your diagrams.

Tags appear in the top left corner, next to the diagram's name.

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.