> For the complete documentation index, see [llms.txt](https://docs.siminsights.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.siminsights.com/hyperskill-studio-authoring/authoring-a-simulation.md).

# Authoring a simulation

Build your first simulation in HyperSkill Studio: the scene, the tasks, and playing it back.

## Overview

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FyTbhDVAKPwZj4Sa4khrW%2Fimage.png?alt=media&#x26;token=53910a2a-bb2e-44f7-8ce3-663d50671b33" alt=""><figcaption></figcaption></figure>

## Building your first simulation

{% stepper %}
{% step %}

### Create the simulation

Select **Create New Sim** in the top right corner of the My Sims page, which opens by default when you launch the app. Name the simulation, choose a virtual space from the list, and press **Create**.
{% endstep %}

{% step %}

### Learn to move around

The camera controls are the same ones a learner uses. See [Controls](/start-here/controls.md).

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FFoEDYvx5v7H0tzAArbQV%2F86.png?alt=media&#x26;token=0e8e047f-b873-497b-964b-d74e27d3690b" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Choose a task type

Click the dropdown to select the task you want.

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FygFRa0tDi6cOWgcufAqe%2F87.png?alt=media&#x26;token=b884bc96-c12a-457c-8da8-9b31aba91203" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Add your steps

Click the Plus button ![](https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FW7X9Tc7AXgkqkwb2Kzoz%2F88.png?alt=media\&token=4c89861d-cea2-4d31-ba6e-8391e767b7ea) to add the first step of your instructions, then fill out the fields of the task. Repeat for every step.

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FtlR5JZZ4UNgcDv8HMEsj%2F89.jpg?alt=media&#x26;token=5adec4af-faad-4476-a989-c86543a52a8a" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Save and play

Click the save icon ![](https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FmuG1Uoa9ki1d2LxUyXsY%2F90.png?alt=media\&token=2b884ce5-c64a-4c01-9582-1ec8894edb8f) to save your changes, then press **Play** to enter experience mode and try it as a learner would.
{% endstep %}
{% endstepper %}

Your simulation appears under [**Sims**](https://platform.siminsights.com/simulations) in HyperSkill Platform, where you can share it, duplicate it, and see analytics for every run. See [Your sims and assets](/hyperskill-studio-authoring/your-sims-and-assets.md).

## Going further

* Placing and adjusting objects: [Scene Layout](/hyperskill-studio-authoring/authoring-a-simulation/scene-layout.md) and [Inspector](/hyperskill-studio-authoring/authoring-a-simulation/inspector.md).
* Making the simulation react to what a learner does: [State machine reference](/hyperskill-studio-authoring/state-machine-reference.md).
* Scoring what they did: [Scoring and mastery](/scoring-and-mastery.md).
