# Yarn Spinner for Unity

<img src="https://downloads.yarnspinner.dev/get/YarnSpinnerLogo.png" alt="Yarn Spinner logo" width="100px;" align="right">

> [!TIP]
> To get Yarn Spinner, and support the team behind it, buy a copy for Unity from [the Yarn Spinner Itch.io Store](https://yarnspinner.itch.io) or from [the Unity Asset Store](https://assetstore.unity.com/packages/tools/behavior-ai/yarn-spinner-for-unity-267061), or check out the [Yarn Spinner Documentation](https://docs.yarnspinner.dev) to install from Git.

[![openupm](https://img.shields.io/npm/v/dev.yarnspinner.unity?label=openupm&registry_uri=https://package.openupm.com)](https://openupm.com/packages/dev.yarnspinner.unity/)

[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 thousands of amazing 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), [Dredge](https://www.dredge.game/), [Frog Detective](https://frogdetective.net/), [Button City](https://www.buttoncitygame.com/), [Escape Academy](https://escapeacademygame.com/en), [Baladins](https://www.baladinsgame.com/), and [Unbeatable](https://www.unbeatablegame.com/).

To get Yarn Spinner, and support the team behind it, buy a copy from [the Yarn Spinner Itch.io Store](https://yarnspinner.itch.io) or from [the Unity Asset Store](https://assetstore.unity.com/packages/tools/behavior-ai/yarn-spinner-for-unity-267061), or check out the [Yarn Spinner Documentation](https://docs.yarnspinner.dev).

This repo contains the Unity integration; you can find the core [Yarn Spinner compiler](https://github.com/YarnSpinnerTool/YarnSpinner) in its own repository.

## Getting Started

Installation instructions, documentation, tutorials, plus additional information is available in the [Yarn Spinner documentation](https://docs.yarnspinner.dev).

## Getting Help

For help, support, discussion, and chill community times, come and join the [Yarn Spinner Discord](https://discord.gg/yarnspinner)!

## Credits

Yarn Spinner is developed by [Secret Lab](https://secretlab.games/), along with a huge community of contributors.

The logo was made by [Cecile Richard](https://www.cecile-richard.com/).

This project has been assisted by the Australian Government through the [Australia Council](https://www.australiacouncil.gov.au/), its arts funding and advisory body. Yarn Spinner's development is made possible in part by [NYU Game Center](https://gamecenter.nyu.edu/). 

## Help Us Make Yarn Spinner!

Yarn Spinner needs your help to be as awesome as it can be. You don't have to be a coder to help out - help might mean promotion, ideas, great explanations for our documentation, anything!

* Yarn Spinner's development is powered by our wonderful Patreon supporters, and purchases on storefronts like Itch.io. If you can afford to do so, [becoming a patron](https://patreon.com/secretlab), or [buying Yarn Spinner on Itch.io](https://yarnspinner.itch.io) would really help us to continue making Yarn Spinner.
* Our [issues repo](https://github.com/YarnSpinnerTool/IssuesDiscussion/issues) contains problems we're solving and features we're considering. Any issues you make will work to make Yarn Spinner better for everyone.
* Follow [Yarn Spinner on Bluesky](https://bsky.app/profile/yarnspinner.dev), or [tell us about a game you're making with Yarn Spinner!](https://www.yarnspinner.dev/tell-us). 

If you want to contribute to Yarn Spinner, [go read our contributor's guide!](CONTRIBUTING.md)