finds.dev

YarnSpinnerTool/YarnSpinner

The core compiler and engine-agnostic components for Yarn Spinner, the friendly dialogue tool.

View on GitHubHomepage ↗

★ 2,870C#MITupdated Nov 2026

// the take

Yarn Spinner is a dialogue-scripting language and compiler for writing branching conversations in games — a screenplay-like syntax that writers can use directly, compiled down to bytecode a game engine runs. This repo is the engine-agnostic core (lexer/parser/compiler/runtime); most people will actually consume it through the separate YarnSpinner-Unity package.

It's a real compiler, not a templating hack: ANTLR-generated grammar, a constraint-based type solver with inference, and a numbered diagnostics system (YS0001-YS0064) with documented examples for each error. Shipped and battle-tested in commercial games (Night in the Woods, A Short Hike, Dredge, Venba), which is a rare thing to see for a game-dev tool of this size. Active language evolution beyond basic branching — node groups, smart variables, saliency strategies for picking which line/option to surface — shows this isn't a frozen 1.0 toy. Engine-agnostic core is cleanly separated from the Unity integration, so a Godot or custom-engine port is plausible without forking the language itself.

In practice the core is Unity-adjacent: non-Unity engines get no first-party integration, so you're writing your own VM host and asset pipeline against this repo's API directly. It's run by a 2-person commercial studio (Yarn Spinner Pty Ltd) monetizing through Itch/Asset Store sales and Patreon — fine for now, but project continuity is tied to that revenue rather than a broad maintainer base. The custom language is a real adoption cost: writers need to learn Yarn syntax, and features like node groups and smart variables add conceptual overhead that's easy to underestimate for a small team. No built-in localization workflow beyond string tables — wiring it into an actual translation pipeline (Crowdin, POEditor, etc.) is entirely on you.

We read the README, the directory tree and a key source file in November 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
2,870
Forks
235
Language
C#
License
MIT
Last commit
3 Nov 2026

// nearby

If YarnSpinner isn't quite it.

All repos →