Add Charts to visualise and help balance your game's parameters.

Charts make it possible to plot multiple variables while running your diagrams, to visualise possible outcomes, and help you monitor certain parameters either standalone, or in relationship to others.

To plot, right click any Pool in your diagram and select Show in Chart from the contextual menu.

The default colour used in the chart for plotting is the Pool's colour, NOT the Resource's colour - as 1 Pool may contain Resources of different colours.

Use the Style & Text > Colour menu on the right to select the Pool's shade.

You can also overwrite the default colour directly from the Chart panel, in the Chart's legend.

To better understand the difference between Pool and Resources colours, read more about it here:

On the y-axis Machinations plots the values of the Pools.

The x-axis represents the number of time steps executed.

Here's an example of plotting 2 variables. In a basic diagram representing a running game, we are plotting Coins earned by a player during a run and the Difficulty Factor that influences the player's Chance of Error (aka crashing into obstacles).

In the video above, Machinations simulates one run, and plots the evolution over time steps of the 2 Pools. Notice this run took over 100 seconds (time steps). By the time the run was over, the player accumulated 272 Coins and reached a Difficulty Factor of 51.

A quick look at the chart could tell us that we may possibly be handing out Coins at a too high rate. From here on, you can start iterating, and answering questions like: Is it an early or a late run issue? Do I have enough content for my player to sink the Coins, or can the rate of Coin collecting result in inflation? How does this chart look like when I introduce power-ups? Should I increase the Difficulty Factor?

Chart Options

All Chart Options can be found in the Options Bar, found at the top of the plotting area.

Chart Types

There are 3 types of charts you can use to visualise your data: Line, Area and Bar Chart. Select the one that fits best, in the top bar of the plotting area, next to the chart's name.


Currently, there are 2 options: CSV export of the simulations values, or an image export of the chart

You can run multiple simulations on the same chart instance by:

  1. Stopping and running the diagram manually

  2. Setting a limited number of steps for which to run the simulation

  3. Having an End Condition on the diagram

To see the plotted results for each of these iterations, use the buttons in the top bar of the chart to navigate through them.

Use the Eraser button (Chart Options bar > Right Corner) to clear the chart content.