Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Yarn Spinner

yarnspinner.dev

  • Free plan
  • Open source
  • Windows
  • macOS
  • Linux
  • Web
  • Browser extension
  • API
8.7 Club score Visit yarnspinner.dev

What Yarn Spinner is

Yarn Spinner is a set of narrative game tools for planning, writing, integrating, and testing dialogue. Its human-readable Yarn scripting language supports interactive conversations and branching narratives, with official integrations for Unity, Godot using C# or GDScript, and Unreal Engine using Blueprint or C++. The free, open-source Visual Studio Code extension offers syntax highlighting, error checking, a graph view, and in-editor dialogue preview. Writers can export dialogue strings with unique IDs and switch languages at runtime; the tools can also use Unity Localization. Voice-over support includes audio asset management, localization synchronization, and playback timing. Ready-made add-ons include speech bubbles and dialogue wheels, while Text Animator is included in Yarn Spinner+. Try Yarn Spinner is a browser tool for writing and running scripts without setup, but those scripts stay in browser localStorage and are not backed up or synchronized. The core is under the MIT License. Free is free; Yarn Spinner+ for Unity is $75 or more, once.

Who it suits

Yarn Spinner suits writers, programmers, and game designers creating dialogue or branching stories for Unity, Godot, or Unreal Engine. Its free VS Code extension and browser tool may help teams start writing without a paid plan.

Good to know, and what to watch

  • Human-readable language for interactive dialogue
  • Official integrations for Unity, Godot, and Unreal
  • VS Code extension includes error checking and graph view
  • Supports localization and built-in voice-over tools
  • Core is under the MIT License
  • Browser scripts are not backed up or synchronized
  • Text Animator is included in Yarn Spinner+
  • Yarn Spinner+ for Unity costs $75 or more, once

Free

Free

Yarn Spinner+

$37.50 one-time

Yarn Spinner+ for Unity

$75 one-time

Free plan

Getting started

  1. Open the Yarn Spinner website
  2. Install the free Visual Studio Code extension
  3. Choose Unity, Godot or Unreal integration
  4. Write dialogue in the Yarn language
  5. Preview and check dialogue in Visual Studio Code
  6. Use Try Yarn Spinner in a browser for zero-setup scripting

Limits to check

The Free plan costs nothing and includes open-source software, Unity, Godot and Unreal integrations, plus the VS Code extension. Text Animator integration, dialogue presenters, priority support and bug fixes, and early access require Yarn Spinner+ for Unity at $75 or more, once.

The Club's review

Yarn Spinner is a narrative toolkit for building branching game dialogue, aimed at writers, designers and programmers working inside a game engine. It is most compelling for teams that want readable scripts tied to Unity, Godot or Unreal, with localization and voice-over handled in the same workflow. The core costs nothing, but the browser editor's storage model makes disciplined project backups essential.

Overview

Yarn is a document-based, human-readable language for interactive conversations and branching narratives. That format keeps dialogue approachable for writers while giving designers a structure for quest planning and giving programmers an integration point for runtime content. It is a sensible fit when narrative work needs to move between creative and technical roles rather than remain in a standalone writing app.

The MIT-licensed core and free integrations make Yarn Spinner unusually accessible for commercial or hobby projects. Try Yarn Spinner provides a zero-setup way to write and run scripts in a browser, useful for experimentation or teaching. It is not a reliable archive: scripts stay in browser local storage, are not sent to the company, and receive no backup or synchronization.

Key features

Authoring and structure

The free, open-source Visual Studio Code extension supplies syntax highlighting, error checking, a graph view and an in-editor dialogue preview. In practice, writers can work in a familiar code editor while checking branches visually and catching script problems before runtime. Branching dialogue and quest design support make it suitable for narrative systems that extend beyond a sequence of linear conversations.

Engine integration

Official integrations cover Unity, Godot and Unreal Engine. Godot projects can use either C# or GDScript, while Unreal supports Blueprint or C++. This breadth is a major reason to choose Yarn Spinner when a team wants one dialogue language across different engine pipelines; teams committed to an unsupported engine will need another tool.

Localization and voice

Dialogue exports include unique IDs, enabling a trackable localization workflow. Runtime language switching is supported, and Unity projects can use Unity Localization. Built-in voice-over support adds audio-asset management, synchronization with localized content and playback timing, reducing the need to assemble separate dialogue systems. Ready-made speech bubbles, dialogue wheels and Text Animator effects can speed presentation work, although Text Animator is reserved for the paid Unity plan.

Browser and privacy

Try Yarn Spinner runs without setup and keeps scripts in local storage. That limits exposure to the company and analytics are anonymized through Umami, while web traffic uses HTTPS and infrastructure access is restricted to necessary team members. The trade-off is operational: browser scripts are not synchronized or backed up, so production projects should live in a managed repository or local project files.

Pricing

PlanPriceWhat you get
FreeFree, free foreverOpen-source core, Unity, Godot and Unreal integrations, and the VS Code extension.
Yarn Spinner+ for Unity$75, paid once (billed $75 or more)Text Animator integration, dialogue presenters, priority support and bug fixes, plus early access.

The free plan is the clear choice for independent creators and teams that need the language, editor and engine connections without a licence bill. Yarn Spinner+ is a one-time Unity purchase for teams that specifically need its presentation add-ons and enhanced support; it does not add a separate Godot or Unreal tier. Email support generally replies within a few business days, and a community Discord provides another route for help. Consulting, custom integrations, feature development, training and narrative design are offered separately by Yarn Spinner Pty. Ltd.

Platforms

Yarn Spinner is offered as an extension and supports Linux, macOS, Windows and web access through Try Yarn Spinner. Runtime integrations target Unity, Godot and Unreal Engine, with the language usable alongside Godot's C# or GDScript and Unreal's Blueprint or C++ workflows.

Who it's for

Choose Yarn Spinner for a game team that needs writers, designers and programmers to share a readable dialogue format while retaining engine-level control. It is particularly well suited to branching stories, quest-driven games and projects with localization or recorded dialogue requirements. Solo developers benefit from the free, MIT-licensed core and broad engine coverage.

Look elsewhere if your priority is a browser-first workspace with automatic backup and synchronization, since Try Yarn Spinner does not provide those safeguards. Unity teams wanting the paid presentation components should budget for Yarn Spinner+; teams that do not need those add-ons can remain on the free plan.

Pros and cons

  • Pro: A human-readable, document-based language bridges creative writing and technical implementation.
  • Pro: Free integrations span Unity, Godot and Unreal, with a capable open-source VS Code extension.
  • Pro: Export IDs, runtime language switching and Unity Localization support give localization a defined workflow.
  • Pro: Voice-over asset management and timing are built into the feature set.
  • Con: Browser scripts remain only in local storage, with no backup or synchronization.
  • Con: Text Animator, dialogue presenters, priority support and early access require the paid Unity plan.

Alternatives

articy:draft X is a better fit for users wanting a free plan with 700 objects per project, unlimited projects and a €7.98 monthly single-user option.

ink and Inky suits developers seeking a free MIT-licensed writing tool with Linux, macOS and Windows support.

Narrat is a free, open-source option for personal or commercial use, including web support.

ChatMapper fits projects needing a free tier with one editor, three projects and 300 nodes per project.

Narratyr is another freemium narrative tool with a free visual editor and open document format.

Ren'Py is a free choice for visual-novel development across desktop, mobile and web platforms.

Arcweave offers a browser-based free tier with three projects and 200 items per project.

Naninovel is a paid tool with a free trial for teams that prefer that model.

See the Game Narrative Design Software list for more options.

Verdict

Yarn Spinner is a strong recommendation for narrative game teams that want an open, readable dialogue language connected directly to Unity, Godot or Unreal. Its localization and voice-over workflow adds practical value beyond basic branching scripts, and the free core removes a major adoption barrier. Choose another platform if browser-based collaboration with automatic project backup is central, or if you need presentation features without paying for the Unity add-on.

The verdict

Yarn Spinner combines a readable dialogue language with editor tools, engine integrations, localization, and voice-over support. Note that browser scripts remain only in localStorage, and some add-ons are part of the paid Unity plan.

Questions people ask

Is Yarn Spinner free?

The Free plan is free and includes the open-source core, Unity, Godot and Unreal integrations, and the VS Code extension.

What does Yarn Spinner+ for Unity cost?

Yarn Spinner+ for Unity is listed at $75 or more, billed once.

Which engines does it support?

Official integrations support Unity, Godot with C# or GDScript, and Unreal Engine with Blueprint or C++.

Is Yarn Spinner open source?

The core is provided under the MIT License, and the Visual Studio Code extension is free and open source.

Can it handle localization?

It exports dialogue strings with unique IDs, supports runtime language switching and can use Unity Localization.

What the maker publishes

Authoring and testing
The graph view displays connected nodes and supports arranging the story; nodes can be played in the editor. source
Browser data limit
Scripts in Try Yarn Spinner remain in browser localStorage, are not sent to the team and are not backed up or synchronized. source
Browser data limitation
Browser scripts are not synchronized or backed up, so users are told to save work to disk regularly. source
Browser privacy
Browser tools compile and run locally, keep scripts in localStorage and do not send script contents to Yarn Spinner servers. source
Browser tool
Try Yarn Spinner is a zero-setup browser tool for writing and running Yarn scripts. source
Browser tool
Try Yarn Spinner runs Yarn scripts and dialogue directly in a browser with no installation. source
Commands and game integration
Commands can trigger game events, update variables and control game state from Yarn scripts. source
Company headquarters
The company is based in Hobart, Tasmania, Australia. source
Company legal identity
The maker identifies itself as Yarn Spinner Pty. Ltd., an Australian private company. source
Company location
Yarn Spinner is located in Hobart, Tasmania, Australia. source
Company origin
Yarn Spinner operates as a spinoff from Secret Lab and was created during Night in the Woods development. source
Company size listing
LinkedIn lists Yarn Spinner Pty. Ltd. as privately held with 51–200 employees. source
Core licence
The core Yarn Spinner repository is published under the MIT License. source
Core purpose
Yarn Spinner makes tools for planning, writing, managing and delivering game dialogue and narrative. source
Dialogue language
Yarn is a screenplay-like language with choices, variables, storylets, commands and markup. source
Dialogue preview
Writers can play through dialogue inside VS Code and preview scripts in the browser without installing an engine. source
Dialogue UI
Built-in and customizable dialogue views can show lines, character names and options, while custom views can be created. source
Documentation depth
Documentation covers beginner scripting, fundamentals, advanced scripting, engine guides, add-ons, samples, API reference, FAQ and migration. source
Editor
The free open-source Visual Studio Code extension provides syntax highlighting, error checking, graph view and in-editor dialogue preview. source
Engine integrations
Official integrations support Unity, Godot with C# or GDScript, and Unreal Engine with Blueprint or C++. source
Engine integrations
Official integrations are provided for Unity, Godot and Unreal. source
Free edition
Free editions are offered for Unity, Godot and Unreal; the free version is open source. source
Function extensibility
The Library API lets developers register, import, query and remove functions callable from Yarn programs. source
Godot editor platforms
Godot GDScript editor package supports Windows, macOS and Linux. source

Checked against the maker's pages on 18 Nov 2026.