# Interface

![](https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLmZ8pg41pNiuDaXEPS%2F-MLmZgd1V07ENErhIEA8%2Fmachinations_new_ui_img_2x.png?alt=media\&token=3cb415db-9bff-4890-98b2-e974a1495a2d)

Your **Machinations Workspace** is where you’ll create your game designs, set parameters, run simulations, and plot results.

## Header Bar

![](https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLmZ8pg41pNiuDaXEPS%2F-MLm_9Iv1LH6FJ2aZGiG%2Fimage.png?alt=media\&token=5b720cc3-271c-442f-a01a-3b18d8838018)

From the header you can easily access some of our most important features:

* [x] [Live Collaborative Editing](https://machinations.gitbook.io/docs/collaboration/live-collaborative-editing)
* [x] [Share](https://machinations.gitbook.io/docs/collaboration/live-collaborative-editing#share-diagram)
* [x] [User Profile](https://machinations.gitbook.io/docs/accounts/user-profile)
* [x] [Tags](https://machinations.gitbook.io/docs/collaboration/tags)
* [x] [Saving Prompts > Version History](https://machinations.gitbook.io/docs/collaboration/live-collaborative-editing#version-history)

## File Management

Clicking on the diagram's `Title`reveals the file management setting.

<img src="https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MMpn9uYiS97Lw7ih_CA%2F-MMpsxHIt7xVghKVuRth%2Fimage.png?alt=media&#x26;token=ad65dd9e-8131-4a48-9cca-22d580c43130" alt="" data-size="original">&#x20;

Click on the `Manage file` button `Share`; `Make a copy` or `Delete` your diagram. <img src="https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MMpn9uYiS97Lw7ih_CA%2F-MMptxNXa6Nh662i-hsY%2Fimage.png?alt=media&#x26;token=fa9d3bdc-7c8d-4352-b58b-6d8ddc191454" alt="" data-size="original">&#x20;

## Main Menu

![](https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLmZ8pg41pNiuDaXEPS%2F-MLm_Ls-4EV7GJGXxbsr%2Fimage.png?alt=media\&token=9cdd5a3a-8385-4c01-b07c-7a46b3f95604)

In the **Menu** you will find everything you could expect from a Docs suite.&#x20;

### File > Open

![](https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-M4oCXdvSuDc26iaY_BB%2F-M4oY8G2owcCxDwj2_Yl%2Fimage.png?alt=media\&token=95ccde4c-5751-416a-a5f2-f94b602ed77a)

1. **Team Machinations** - is the [Team Folder](https://machinations.gitbook.io/docs/accounts/teams#team-folder), available with our paid plans
2. **My Machinations** - where we store your diagram that are not shared with your team members
3. **Shared with me** - a folder for the diagrams to which you've been invited to edit
4. **Templates** - where you can find the templates we make public

{% hint style="success" %}
This should be interesting for both beginner and advanced users. Quickly access a ready-built diagram and investigate see how it works.&#x20;

:man\_mage: It’s a nice way of getting over the empty canvas block every one of us may experience.

:bulb: Templates cam also be accessible from **File > New from Template**
{% endhint %}

## Nodes and Libraries

<div align="left"><img src="https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLmZ8pg41pNiuDaXEPS%2F-MLm_mQTo9hCPQSitzuP%2Fimage.png?alt=media&#x26;token=235692dc-5850-46b2-969d-fdcac4ee08c9" alt=""></div>

Access all Nodes and Connections to drag and drop them onto the canvas.

{% hint style="success" %}
:woman\_superhero: Pro-tip: Double click Nodes to automatically place & connect them.

Read more on this in [Best Practices](https://machinations.gitbook.io/docs/tips/best-practices)
{% endhint %}

## Libraries

![](https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MMLp9QYm-HD1Bp1w5Wo%2F-MMPm4iC8J-UgGf3vtHx%2FScreen%20Recording%202020-11-18%20at%2011.50%20AM.gif?alt=media\&token=a106c231-2157-4584-8058-823648163796)

### Public

Access a searchable repository of ready-made subsystems. Drag and drop them onto the canvas to get you started. &#x20;

### Private

Add systems for easy drag and drop access. `Select` the Nodes and Connections you’d like added `right-click` and select `Add to private library` (see below).

![](https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MMLp9QYm-HD1Bp1w5Wo%2F-MMPmkIdI1I0UimWa7jb%2Fimage.png?alt=media\&token=202ac6aa-13ca-4c2a-b600-c031c0440945)

## Properties Panel

![](https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLmZ8pg41pNiuDaXEPS%2F-MLmaCuw_AbCPp0DN7D7%2Fimage.png?alt=media\&token=2e7be730-eb12-4806-8b49-22b3b4cec5b9)

### **Diagram**

:bulb: When **no component** is selected on the diagram, the panel displays the options for changing diagram properties:

* [x] Global Properties
  * [x] Dice: choose the number of the default die has, by default (eg: D6 - a die with 6 faces)
  * [x] Skill:
  * [x] Multiplayer:
  * [x] Strategy:
* [x] View: choose if you want to have de Grid or Page View on/off
* [x] Options: Toggle on/off Connection arrows or Guides

:wrench: When components (Nodes & Connections) are selected, this panel displays the properties settings for that component.

## Run Bar and Chart

![](https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLmcElfO65KteCTTVsB%2F-MLmcba39RjhB4Q9DZUs%2Fimage.png?alt=media\&token=5e9c5a5a-0ce7-4448-9e64-88de5756bd84)

### Types of Runs (simulations)

Once you have a system diagrammed, in the bottom panel you can find the diagram's [**Run Modes**](https://machinations.gitbook.io/docs/simulations/simulations)&#x20;

When Run mode is set on "animated", you can run your diagram in 2 modes:

1. <img src="https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLmcElfO65KteCTTVsB%2F-MLmdJ8qY39WhmHt-HdI%2Fimage.png?alt=media&#x26;token=2956493b-6f49-45f6-bab6-7ccba82e0780" alt="" data-size="line"> [***Run***](https://machinations.gitbook.io/docs/simulations/simulations#1-run)
2. <img src="https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLmcElfO65KteCTTVsB%2F-MLmdYBmrOOoMvG4P_jB%2Fimage.png?alt=media&#x26;token=59567443-b763-4f49-bbda-a10ce46fe6de" alt="" data-size="line"> [***Step-by-Step Run***](https://machinations.gitbook.io/docs/simulations/simulations#2-step-by-step-run)

![](https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLmcElfO65KteCTTVsB%2F-MLmeffdJztvD30lQFG6%2FScreen%20Recording%202020-11-10%20at%2004.58%20PM.gif?alt=media\&token=1a366706-4b9b-401d-92ac-ec743dce2a2b)

Switch to "quick run", and 2 other options become available:

1. <img src="https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLmcElfO65KteCTTVsB%2F-MLme5Eamfbesbd_xABM%2Fimage.png?alt=media&#x26;token=2041262e-b4b9-4e89-a88f-afa1cb8e49b1" alt="" data-size="line"> [***QuickRun***](https://machinations.gitbook.io/docs/simulations/simulations#3-quick-run)
2. <img src="https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLmcElfO65KteCTTVsB%2F-MLmfd22Y9iwthumhlnz%2Fimage.png?alt=media&#x26;token=8668ca67-47e1-4a0f-ab88-119fe1785d53" alt="" data-size="line"> [***MultipleR*****un**](https://machinations.gitbook.io/docs/simulations/simulations#4-multiple-runs)

### Execution Chart

![](https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLmhESph2oDmOGV1RSX%2F-MLmheepbZeOrSYS2SZd%2Fimage.png?alt=media\&token=97f564e8-a069-466b-ad99-1ef9158b2fa9)

<img src="https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLmhESph2oDmOGV1RSX%2F-MLmi-kzi1S_0Ed2EscM%2Fimage.png?alt=media&#x26;token=488c04ac-52f3-4b19-8b51-4ab593f5e5c2" alt="" data-size="line"> Opens the [**Execution Chart**](https://machinations.gitbook.io/docs/simulations/charts) of your diagram.

## View Controller

![](https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLnFNcoUXY3BT31yHmr%2F-MLqG1JFIqC-zSGty1Pj%2Fimage.png?alt=media\&token=d47a53ea-f2d5-4d84-9903-522a91bde085)

### Layers

![](https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLnFNcoUXY3BT31yHmr%2F-MLqIEp-yvfqmytuVUXS%2Fimage.png?alt=media\&token=a37e24cd-c1b2-4638-8a8e-0602f84e6df6)

Use Layers for different sections of your diagram, so you can hide them if you need better visualisation at a micro or macro level.

1. Open Layers controller by clicking the Layers icon (image above)
2. Make a **selection** of Nodes and Connections
3. **Add Layer** with <img src="https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLnFNcoUXY3BT31yHmr%2F-MLqIfWMI2j-2sGxeXsX%2Fimage.png?alt=media&#x26;token=e5c966a7-e97d-4e64-a077-92f02eeb6968" alt="" data-size="line">&#x20;
4. **Move selection** to a different Layer by Selecting the target Layer from the list, and hitting <img src="https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLnFNcoUXY3BT31yHmr%2F-MLqIcrHKi_qUC63UQ8V%2Fimage.png?alt=media&#x26;token=3c674f91-5ba8-484a-b8ee-1da74a30e293" alt="" data-size="line">&#x20;
5. **Duplicate** Layer with <img src="https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLnFNcoUXY3BT31yHmr%2F-MLqIjKrj6Qq5kdspGJV%2Fimage.png?alt=media&#x26;token=15963dfd-48cf-45b4-9a49-bd199bed4745" alt="" data-size="line">&#x20;
6. **Delete** a Layer with <img src="https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLnFNcoUXY3BT31yHmr%2F-MLqKNqQLeNsynXuSwJq%2Fimage.png?alt=media&#x26;token=4e673713-77d7-4940-9ebe-c0838810aebb" alt="" data-size="line">&#x20;
7. **View/Hide** Layer <img src="https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLnFNcoUXY3BT31yHmr%2F-MLqKbCz4SHxiuhUrJlJ%2Fimage.png?alt=media&#x26;token=be3d3699-cf3d-4b31-bad5-c71d08d24438" alt="" data-size="line">&#x20;
8. &#x20;**Lock/Unlock** Layer <img src="https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLnFNcoUXY3BT31yHmr%2F-MLqKxPPWU7bUOD5fY-F%2Fimage.png?alt=media&#x26;token=acb126bc-24fe-4c8b-84dc-c61080d996be" alt="" data-size="line">

### Outliner

![](https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLnFNcoUXY3BT31yHmr%2F-MLqPOCcrqVI46WQrv_2%2Fimage.png?alt=media\&token=ec251774-be74-4207-9f54-3a4e1fa4ced2)

Use this as a minimap, by draging the ouline to navigate the diagram.

### Fit to screen

![](https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLnFNcoUXY3BT31yHmr%2F-MLqQ74IwgmjCuBCw1-p%2FScreen%20Recording%202020-11-11%20at%2010.29%20AM.gif?alt=media\&token=a6915d2c-8a6d-4507-8251-08ea5779f381)

### Zoom

![](https://2667914601-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LGZcALyOGDKb9q0wdJ5%2F-MLnFNcoUXY3BT31yHmr%2F-MLqQLJaOHQ5eHOZ3xma%2Fzoom.jpg?alt=media\&token=376be082-159a-4253-b99b-2194162302fd)
