Quick Start

Pretty confident with Unity and want to use Yarn Spinner in a new project right away? Follow these steps. Otherwise, continue to TODO the next step.

Setting Up A Demo Scene

1. Create a new empty Unity project, by following the instructions in the Unity manual.
2. Install Yarn Spinner into the project, by following the instructions in installation-and-setup.md.
3. Add a Dialogue System to the scene:, by opening the GameObject menu and choosing Yarn Spinner -> Dialogue Runner.
4. Create a new Yarn script, by opening the Assets menu and choosing Create -> Yarn Spinner -> Yarn Script. Name the new file HelloYarn.
5. 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 official Yarn Spinner Extension at: editing-with-vs-code. {% endhint %}

1. Save the file and return to Unity.
2. Create a new Yarn Project 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.
3. Make the Dialogue Runner use the Project by dragging the Project you just made into the Dialogue Runner’s Yarn Project field.
4. Play the game by clicking the Play button at the top of the window. Your dialogue will appear!