# Unity Quick Start

{% hint style="danger" %}
Want to use Yarn Spinner in a new scene in Unity right away? Follow these steps. If this is your first time using Yarn Spinner, or you're a bit unsure how it all works, we suggest reading the rest of the documentation first!
{% endhint %}

{% embed url="<https://www.youtube.com/watch?v=OoVBRmeUYMA&t=1s>" %}

## Basic Yarn Spinner for Unity Usage

1. **Install Unity 2022.3 or newer**.
2. **Create a new empty Unity project**, by following [the instructions in the Unity manual](https://docs.unity3d.com/Manual/GettingStarted.html).
3. **Install Yarn Spinner into the project**, by following the instructions in [Installation for Unity](/yarn-spinner-for-unity/installation-and-setup.md).
4. **Add a Dialogue System to the scene:**, by opening the GameObject menu and choosing Yarn Spinner -> Dialogue System.
5. **Create a new** **Yarn Spinner Script**, by opening the Assets menu and choosing Create -> Yarn Spinner -> Yarn Script. Name the new file `HelloYarn`.
6. **Open the new Yarn script** by double-clicking it.
   1. Select all of the text in the file, and delete it.
   2. Copy the text below, and paste it into the file.

```
title: Start
---
Wow!
My first ever Yarn script in Unity!

-> Gosh!
-> Incredible!
-> I'm amazed!

Anyway, time to get writing!
===
```

{% hint style="info" %}
You can learn about our recommended editor, Visual Studio Code with the [Yarn Spinner for Visual Studio Code extension](/write-yarn-scripts/yarn-spinner-editor.md).
{% endhint %}

7. **Save the file and return to Unity.**
8. **Create a new** [**Yarn Project**](/yarn-spinner-for-unity/yarn-spinner-in-unity-scenes/yarn-projects.md) **that uses this script**, by selecting the `HelloYarn` file, and clicking the Create New Yarn Project button in the Inspector. This will create a new Yarn Project called `Project`. Projects are collections of Yarn scripts that get compiled together, and can be used with a Dialogue Runner.
9. **Make the Dialogue Runner use the Project** by dragging the Project you just made into the Dialogue Runner's Yarn Project field.
10. **Play the game** by clicking the Play button at the top of the window. Your dialogue will appear!


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.yarnspinner.dev/yarn-spinner-for-unity/installation-and-setup/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.