> For the complete documentation index, see [llms.txt](https://docs.yarnspinner.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yarnspinner.dev/2.1/readme.md).

# Start Here

## **Welcome to Yarn Spinner!**

[**Yarn Spinner**](https://yarnspinner.dev) **is the friendly tool for writing dialogue in games.** It's easy for writers to use, and has powerful features for programmers.

Yarn Spinner is a dialogue system that lets you write interactive conversations in a simple, screenplay-like format, which can be loaded into your game and run.

When a conversation is running, Yarn Spinner sends your game **lines** of dialogue to show, **options** to let the player choose from, and **commands** to make things happen in your scene.

Yarn Spinner has been used in a number of critically acclaimed games, including [Night in the Woods](http://nightinthewoods.com), [A Short Hike](https://ashorthike.com), [Lost in Random](https://www.ea.com/en-au/games/lost-in-random), and many more.

It's free to download and use for free and commercial games, and is open source under the terms of the [MIT License](https://choosealicense.com/licenses/mit/).

**Yarn Spinner 2.1** is our latest release!

![](/files/txZGoUBByvfwIt2UIAIR)

{% hint style="info" %}
**This documentation is still in active development.** If you see an issue, please [file an issue on GitHub](https://github.com/YarnSpinnerTool/YSDocs/issues/new).
{% endhint %}

**Yarn Spinner is made up of two things:**

1. Yarn files that contain the script for your game, and;
2. The Yarn Spinner framework for your chosen game engine or method of delivery.

{% hint style="warning" %}
**This documentation is for Yarn Spinner 2.1.** You can find the old Yarn Spinner 1.0 documentation [here](https://yarnspinner.dev/docs/), if you still need it.
{% endhint %}

**To use Yarn Spinner, you will need:**

1. **An editor to write and edit .yarn scripts with.** We recommend using the official Yarn Spinner Visual Studio Code extension, together with Visual Studio Code.
   * You can find details on installing VS Code and the official Yarn Spinner Visual Studio Code Extension here: [Editing with VS Code](/2.1/getting-started/editing-with-vs-code.md)
2. **A copy of Yarn Spinner for your game engine of choice.** Currently, Yarn Spinner supports Unity, so you'll need Yarn Spinner Unity.
   * You can learn more about Yarn Spinner Unity here: [Overview](/2.1/using-yarnspinner-with-unity/overview.md)
3. **A .yarn script (or a few of them).** These will be the narrative, or bits of narrative, that Yarn Spinner uses to display and deliver your dialogue.
   * You can learn more about writing in Yarn here: [Writing in Yarn](/2.1/getting-started/writing-in-yarn.md)

{% hint style="danger" %}
Yarn Spinner currently only officially supports Unity. There are community projects for other game engines, and we're officially working on more. Stay tuned for updates.
{% endhint %}

You can also learn more about the various [GitHub Repositories](/2.1/about/github-repositories.md), as well as [The Team](/2.1/about/team.md) here, if you'd like.

{% hint style="info" %}
If you'd like to join the wider Yarn Spinner community, we also have a [Yarn Spinner Discord](https://discord.gg/yarnspinner).
{% endhint %}