Pardon our dust while we move our docs here. The Godot (GDScript) docs are on this site, and the Yarn language, Unity, Godot (C#) and Unreal docs are still at docs.yarnspinner.dev.

Yarn Spinner for Godot (GDScript) is free and open source. Yarn Spinner+ for Godot (GDScript) is the paid version. It comes with add-ons, which are ready-made dialogue systems you can add to your game and restyle.

What’s included

Yarn Spinner+ for Godot (GDScript) includes two add-ons:

  • Classic RPG: a dialogue box in the style of old-school RPGs, with a typewriter you can speed up and pause, a skip button, item icons, and a choice of box styles.
  • Snaaake: a two-character radio conversation in the style of classic action games, with talking heads, voice-over and subtitles.

Each add-on is a Godot addon folder that works with the free Yarn Spinner for Godot (GDScript), and comes with a sample scene.

Getting Yarn Spinner+

Buy Yarn Spinner+ for Godot (GDScript) from our itch.io store. It’ll be on the Godot Asset Store too, as soon as the store allows paid assets. See Installation for how to add it to your project.

Installing an add-on

Each add-on needs Yarn Spinner for Godot (GDScript) and Godot 4.6 or later. They come in the same download as Yarn Spinner+. To install one:

  1. Copy the add-on’s folder, like yarn_spinner_classic_rpg, into your project’s addons folder, next to yarn_spinner.
  2. Make sure the Yarn Spinner plugin is turned on in ProjectProject SettingsPlugins.
  3. Optionally, turn on the add-on’s own plugin there too. It doesn’t add anything you need, but it warns you if the Yarn Spinner plugin is off.
Godot's Project Settings window on the Plugins tab, with three plugins turned on: Yarn Spinner 3.2, Classic RPG for Yarn Spinner 1.0.0, and Snaaake for Yarn Spinner 1.0.0
Yarn Spinner and both Yarn Spinner+ add-ons turned on.

In this section

  • Classic RPG: setting it up, the hashtags and Commands it supports, and restyling it.
  • Snaaake: setting it up, adding characters, and putting them in slots.
Get started Classic RPG A dialogue box in the style of old-school RPGs, included with Yarn Spinner+ for Godot (GDScript).