> 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/quickstarts/for-authors.md).

# For authors

Build your first 3D simulation in HyperSkill Studio, or your first Spark.

There are two kinds of simulation to build, and they are built in different places.

* **3D simulations** are built in **HyperSkill Studio**, in a browser or on Windows. A learner moves around a space and handles objects. Covered in depth under [HyperSkill Studio](/hyperskill-studio-authoring.md).
* **Sparks** are conversational simulations, built in the browser. A learner talks with an AI character and is scored on the conversation. Covered under [Spark](/spark.md).

You can find a detailed video tutorial in our [YouTube playlist](https://www.youtube.com/watch?v=ziAevzrFMDI\&list=PLJbp-d55DdDgoPCWtMcsSpdBEVCczp7oP).

## Build a 3D simulation

{% stepper %}
{% step %}

### Open HyperSkill Studio

In HyperSkill Platform, open [**Get HyperSkill**](https://platform.siminsights.com/settings/downloads). **HyperSkill Online** runs in your browser with nothing to install; **Windows Desktop** is the installed app. See [Get HyperSkill on your devices](/start-here/get-hyperskill-on-your-devices.md).

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2F9DxZJHN05o5lA1MaLv00%2FScreenshot%202026-09-04%20at%2012.24.08%E2%80%AFPM.png?alt=media&#x26;token=f55f278e-1484-403e-8c97-e0a9789d8781" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Create a simulation

Select **Create New Sim** in the top right corner of the My Sims page, which opens by default when you launch the app.

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FQPtpaXVPV6ILbnXUs1JC%2FScreenshot%202026-09-04%20at%2012.28.05%E2%80%AFPM.png?alt=media&#x26;token=327a1674-5a74-4688-a0f3-77f2d2ca99c3" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Name it and pick a space

Give the simulation a name, select a virtual space from the list, and click **Create** in the bottom right corner.

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FVeQPjVBMAWfBmUQCLpN1%2FScreenshot%202026-06-09%20141031.png?alt=media&#x26;token=fa3a2993-5b84-4d45-85d5-ba3e7371b7f2" alt="" width="563"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Author the simulation

The simulation opens in edit mode. Move the camera with the same controls a learner uses, drop objects into the space from the asset library, and use the tabs along the top to add tasks, rules and scoring.

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2Fyj6u7dbmDFGrJ8jzDCbp%2FScreenshot%202026-09-04%20at%2012.48.02%E2%80%AFPM.png?alt=media&amp;token=3dcbbf3d-43d4-4e95-8590-b74c51877f78" alt="" width="563"><figcaption></figcaption></figure>

This is the part with real depth to it. [Authoring a simulation](/hyperskill-studio-authoring/authoring-a-simulation.md) covers building the steps a learner follows, making objects react to what they do, and scoring their performance.
{% endstep %}

{% step %}

### Save and play

Click the save icon <img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FrEFd1xetBQf39EC5nIwv%2FScreenshot%202026-09-04%20at%2012.32.41%E2%80%AFPM.png?alt=media&#x26;token=c906a2f6-8217-4f74-ab52-4e13ef464923" alt="" data-size="line"> to save your changes, then press **Play** to enter experience mode.
{% endstep %}
{% endstepper %}

## Build a Spark

{% stepper %}
{% step %}

### Create the Spark

Go to [spark.siminsights.com](https://spark.siminsights.com), sign in with your HyperSkill account, and create a Spark.
{% endstep %}

{% step %}

### Build the conversation

**Scenario Flow** is the states the conversation moves through, **AI** is the character and the agents that score it, and **Settings** covers the microphone.

<figure><img src="https://2704613365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYaaXoZ4YGbVdAnAhdcE%2Fuploads%2FXlwXMN3Q8LlgtGXOFL5G%2FScreenshot%202026-09-04%20at%2012.56.05%E2%80%AFPM.png?alt=media&amp;token=98b2ed08-6c3d-4bd5-b9f1-494bfc51eedd" alt="" width="563"><figcaption></figcaption></figure>

[Building a Spark](/spark/building-a-spark.md) covers writing the character's instructions, giving it documents to draw on, and setting up the agents that score the conversation and the feedback the learner sees at the end.
{% endstep %}

{% step %}

### Try it

Press **Open experience** to play it as a learner would.
{% endstep %}

{% step %}

### Publish

A Spark cannot be played outside the editor until it is published.
{% endstep %}
{% endstepper %}
