---
description: >-
  If you're new to Yarn Spinner, or want a refresher on getting started or
  navigating the documentation, then this is the place to be.
---

# Start Here

[**Yarn Spinner**](https://yarnspinner.dev) **is a set of friendly tools for writing interactive narratives and games.**

Yarn Spinner is easy for writers to use, but also has powerful features for programmers, game designers, narrative directors, producers, and more.

Yarn Spinner is used in thousands of amazing games, including Rift of the Necrodancer, [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).

<table data-view="cards" data-full-width="false"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden><select></select></th><th data-hidden></th></tr></thead><tbody><tr><td><strong>New? Start Here!</strong></td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FijFhOKujwaqhI1XeZnjZ%2FTry.png?alt=media&#x26;token=89bda0c0-75b2-4379-96a0-66d43034e3fc">Try.png</a></td><td><a href="write-yarn-scripts/start-here">start-here</a></td><td></td><td></td></tr><tr><td><strong>Scripting Fundamentals</strong></td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FVG74eq0HJVIovXC9mCqf%2FSyntax.png?alt=media&#x26;token=bc5c3734-4382-45d5-aef0-ea128da489c4">Syntax.png</a></td><td><a href="write-yarn-scripts/scripting-fundamentals">scripting-fundamentals</a></td><td></td><td></td></tr><tr><td><strong>Advanced Scripting</strong></td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FbnBCEULCyk4aQdZM7scU%2FAdvanced.png?alt=media&#x26;token=9d4c1737-87ef-4a3f-b6ee-c75e1b2d055d">Advanced.png</a></td><td><a href="write-yarn-scripts/advanced-scripting">advanced-scripting</a></td><td></td><td></td></tr><tr><td><strong>Yarn Spinner for Unity</strong></td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FOSTDzNmKg16K01q9qAcU%2FUnity.png?alt=media&#x26;token=56a57c32-d1ed-4947-aab9-2d2f9ccdc95f">Unity.png</a></td><td><a href="yarn-spinner-for-unity/overview">overview</a></td><td></td><td></td></tr><tr><td><strong>Unity Add-Ons</strong></td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FjzkSGAdKeJdotNJ2WzLl%2FAddOns.png?alt=media&#x26;token=14b8b682-eeed-478d-9f9e-d41bcc9d5f21">AddOns.png</a></td><td><a href="yarn-spinner-for-unity/unity-add-ons">unity-add-ons</a></td><td></td><td></td></tr><tr><td><strong>Community Discord</strong></td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FTavmbR8Tx46ytXIdUMXP%2FDiscord.png?alt=media&#x26;token=01c62231-e4c9-4483-a16e-aed3a76ebe8f">Discord.png</a></td><td><a href="https://discord.com/invite/yarnspinner">https://discord.com/invite/yarnspinner</a></td><td></td><td>Join the community.</td></tr><tr><td><strong>Show us your game</strong></td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FYgdz4De1NJmTeQ5oFhOf%2FTellUs.png?alt=media&#x26;token=b0b8c015-8ea5-41fd-ba68-4144ea6498f8">TellUs.png</a></td><td><a href="https://www.yarnspinner.dev/tell-us">https://www.yarnspinner.dev/tell-us</a></td><td></td><td></td></tr><tr><td><strong>Crediting Yarn Spinner</strong></td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FRMkY7XPY8Gj0Tbq5HWXq%2FCredit.png?alt=media&#x26;token=555b76f6-8606-4918-a580-c9d73856e2d3">Credit.png</a></td><td><a href="branding">branding</a></td><td></td><td></td></tr><tr><td><strong>FAQ</strong></td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FdNDTx7FxdyVVAh6dXCIW%2FFAQ.png?alt=media&#x26;token=838aa85e-2729-4003-96b6-159ea6bc8df3">FAQ.png</a></td><td><a href="faq">faq</a></td><td></td><td></td></tr><tr><td><strong>Story Solver</strong></td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2F8tRe4dIImfPRZL2gQAUV%2FStorySolver.png?alt=media&#x26;token=107931f1-3bed-4d04-ab1c-313d00e8ce8f">StorySolver.png</a></td><td><a href="https://www.yarnspinner.dev/storysolver">https://www.yarnspinner.dev/storysolver</a></td><td></td><td></td></tr><tr><td><strong>Yarn Spinner for Godot</strong></td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FEsdzmvWAyhzr7eQ66tvY%2FGodot.png?alt=media&#x26;token=9808b364-0d53-455f-94b5-07d4d3b518f4">Godot.png</a></td><td><a href="yarn-spinner-for-other-engines/godot">godot</a></td><td></td><td></td></tr><tr><td><strong>Yarn Spinner for Unreal</strong></td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2F3ayQTOR5UFJv7ps9SEni%2FUnreal.png?alt=media&#x26;token=613230f6-8cb0-46ae-9669-15e85eb0ec5b">Unreal.png</a></td><td><a href="yarn-spinner-for-other-engines/unreal">unreal</a></td><td></td><td></td></tr></tbody></table>

## What to do next

{% stepper %}
{% step %}
#### [Join the Yarn Spinner Discord](http://discord.com/invite/yarnspinner)

[Join our friendly community Discord](http://discord.com/invite/yarnspinner) before you start working with Yarn Spinner. It's the best place to keep up to date, get support and advice, and share what you're working on
{% endstep %}

{% step %}
#### [Read the Beginner's Guide](beginners-guide)

Yarn Spinner includes a narrative scripting language, Yarn, that allows you to write your game narratives, quests, and logic in a friendly format. The Beginner's Guide will start you off on your path to learning Yarn Spinner.
{% endstep %}

{% step %}
#### Use[ Yarn Spinner in Unity](yarn-spinner-for-unity/overview), Godot, or Unreal

Once you're comfortable writing Yarn Scripts, you can integrate Yarn Scripts with a game engine, such as Unity, Godot, or Unreal. Buy one of [our useful add-ons](yarn-spinner-for-unity/unity-add-ons), too, if you need it!
{% endstep %}

{% step %}
#### Build a Game

Simply draw the rest of the owl.
{% endstep %}

{% step %}
#### [**Tell us about your game**](https://yarnspinner.dev/tell-us) **and** [**Credit Yarn Spinner**](branding)

We'd love to hear about your game, and show it off when we talk about awesome Yarn Spinner-powered games. And please, don't forget to include a credit for Yarn Spinner!
{% endstep %}
{% endstepper %}

## Yarn Spinner powers amazing games, including:

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>DREDGE</td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FFRwpk6AKHYctnV3ZPz48%2FKey%2BArt%2B-%2BDREDGE.png?alt=media&#x26;token=14146b69-fc7a-4af7-b067-f6b75462f187">Key+Art+-+DREDGE.png</a></td><td><a href="https://www.gamedeveloper.com/design/dredge-wasn-t-originally-going-to-be-a-narrative-game-but-then-it-became-one-of-2023-s-best">https://www.gamedeveloper.com/design/dredge-wasn-t-originally-going-to-be-a-narrative-game-but-then-it-became-one-of-2023-s-best</a></td></tr><tr><td>A Short Hike</td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FEqp0YJSdvu2J5uKPCNyd%2FA%2BShort%2BHike.jpg?alt=media&#x26;token=454d289a-957f-4338-98f9-4e6b560807bb">A+Short+Hike.jpg</a></td><td><a href="https://ashorthike.com/">https://ashorthike.com/</a></td></tr><tr><td>Lil' Guardsman </td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FYJkjj0lXrMamMVwWZUTD%2FLiL_Guardsman_key_art_landscape_3840x2160.jpg?alt=media&#x26;token=6e15c87e-7515-4d11-ab58-ea0a41264842">LiL_Guardsman_key_art_landscape_3840x2160.jpg</a></td><td><a href="https://store.steampowered.com/app/1924360/Lil_Guardsman/">https://store.steampowered.com/app/1924360/Lil_Guardsman/</a></td></tr><tr><td>Demonschool</td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FTBsJ7ZHq4PClLUZbdKWn%2Fdemonschool.jpg?alt=media&#x26;token=61c1bc79-6839-4335-9d29-9e71bcac5687">demonschool.jpg</a></td><td><a href="https://necrosoftgames.com/demonschool/">https://necrosoftgames.com/demonschool/</a></td></tr><tr><td>Little Kitty Big City</td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FwqzkgFD8IssKwjdfj0ZT%2Flittlekitty.jpg?alt=media&#x26;token=dfb810a8-ae22-44a6-995b-3b485daa3b4c">littlekitty.jpg</a></td><td><a href="https://www.littlekittybigcity.com/">https://www.littlekittybigcity.com/</a></td></tr><tr><td>Rift of the Necrodancer</td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FlqFqskcaqiTeUkZH7FVQ%2FRift-of-the-NecroDancer-Review-Gamers-Heroes-1-3877274311.jpg?alt=media&#x26;token=8f97d9d8-a992-4631-b5d3-46fb04aedf35">Rift-of-the-NecroDancer-Review-Gamers-Heroes-1-3877274311.jpg</a></td><td><a href="https://braceyourselfgames.com/rift-of-the-necrodancer/">https://braceyourselfgames.com/rift-of-the-necrodancer/</a></td></tr><tr><td>Venba</td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2F5E1j6LMXCxpFpBazjxhd%2Fvenba.jpg?alt=media&#x26;token=57927365-8847-4063-87a6-e4da3b9a2a23">venba.jpg</a></td><td><a href="https://venbagame.com/">https://venbagame.com/</a></td></tr><tr><td>Unbeatable</td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FDVXcu1vlhWmCPEVlUieZ%2F10009766.jpeg?alt=media&#x26;token=e22f0de4-b243-4b6f-8477-94c6c450676c">10009766.jpeg</a></td><td><a href="https://www.unbeatablegame.com/">https://www.unbeatablegame.com/</a></td></tr><tr><td>Luma Island</td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FSYhHXmOOoHgyBMshFK6j%2Fluma-island-pc-game-steam-cover-1276614569.jpg?alt=media&#x26;token=ec36e0b0-b5d0-45ff-87da-8511ebe7e9bb">luma-island-pc-game-steam-cover-1276614569.jpg</a></td><td><a href="https://store.steampowered.com/app/2408820/Luma_Island/">https://store.steampowered.com/app/2408820/Luma_Island/</a></td></tr><tr><td>NORCO</td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FOHiZYBNSthgyePCFQI6j%2Fnorco.jpg?alt=media&#x26;token=25220ee1-e1d6-4ece-ac78-69d4ec608bc5">norco.jpg</a></td><td><a href="https://store.steampowered.com/app/1221250/NORCO/">https://store.steampowered.com/app/1221250/NORCO/</a></td></tr><tr><td>Night in the Woods</td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FeBON6VQfcstpP9HsU0AW%2Fshare.jpg?alt=media&#x26;token=6550eb13-b069-488b-802d-c010ba783a55">share.jpg</a></td><td><a href="http://www.nightinthewoods.com/">http://www.nightinthewoods.com/</a></td></tr><tr><td>ENA: Dream BBQ</td><td><a href="https://3183833785-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1BtiYLyfkkFBrMlsYGWS%2Fuploads%2FuCQoRVemFs1JJIEAcauP%2F15558-download-ena-dream-bbq-pc-mac-game-steam.jpeg?alt=media&#x26;token=73ca9e63-56ba-42e3-9565-5b356ccecb7c">15558-download-ena-dream-bbq-pc-mac-game-steam.jpeg</a></td><td><a href="https://joelgc.com/">https://joelgc.com/</a></td></tr></tbody></table>

**... use it to power your game too!**
