Yarn Spinner
yarnspinner.dev
- Free plan
- Open source
- Windows
- macOS
- Linux
- Web
- Browser extension
- API
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
Plans
Every plan and priceFree
Yarn Spinner+
Yarn Spinner+ for Unity
Free plan
Getting started
- Open the Yarn Spinner website
- Install the free Visual Studio Code extension
- Choose Unity, Godot or Unreal integration
- Write dialogue in the Yarn language
- Preview and check dialogue in Visual Studio Code
- 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
| Plan | Price | What you get |
|---|---|---|
| Free | Free, free forever | Open-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.