v0.3.20 - YarnSpinner libraries v3.2.0 , YSLS JSON generation, new Typewriter API

[dogboydog]

[0.3.20] 2026-05-15

• Upgrade YarnSpinner base libraries to 3.2.0. For details, see https://github.com/YarnSpinnerTool/YarnSpinner/releases/tag/v3.2.0
• Update the source generator to output .ysls.json files, used to integrate with other YarnSpinner tools like the VS Code extension. Updated diagnostics around command registration are also provided.
  • To disable generation of the YSLS file, add the define symbol . Example in your .csproj file: <DefineConstants>$(DefineConstants);YARN_SOURCE_GENERATION_DISABLE_YSLS</DefineConstants>
  • You can now also disable source generation entirely if desired with the symbol YARN_SOURCE_GENERATION_DISABLE_ALL. This will prevent you from using the [YarnCommand] and [YarnFunction] attributes and require manual command and function registration to each dialogue runner.
• Work around Godot issue where exported C# variables can reset to their initial value: remove initial value from DialogueRunner.dialoguePresenters
• Register CustomMarker and BasicMarker as custom types for better editor integration (ERROR: Cannot get class 'BasicMarker' #119)
• Fix a bug where theDialogueRunner.onDialogueComplete signal was emitted twice when dialogue ends. (fix SignalName.onDialogueComplete is emitted twice #120)
• Add dialogueRunner.allowOptionFallthrough which allows dialogue to proceed when no dialogue options were chosen https://yarnspinner.dev/blog/yarn-spinner-3-1-release/#dialogue-option-fallthrough
• ⚠️ Breaking change: The API for returning diagnostics from ReplacementMarkupHandler implementations has changed. Reference PaletteMarkerProcessor for an example of the updates.
• ⚠️ Breaking change: Add redesigned IAsyncTypewriter functionality for typewriter animations. BasicTypewriter is removed. New types of typewriters are available out of the box: Letter (similar to the prior example BasicTypewriter functionality), Word, and Instant.
• Dialogue Presenters now have optional OnNodeEnter and OnNodeExit methods that can be overridden to respond to changes in the running node.
• ⚠️ Breaking change: Remove DialogueViewBase and GDScriptPresenterAdapter, which have been deprecated in favor of DialoguePresenterBase / views implemented directly in GDScript for a while now.
• LocalizedLine now has a Source property that tells you where the line came from (typically a DialogueRunner instance). https://yarnspinner.dev/blog/yarn-spinner-3-1-release/#lines-know-where-they-came-from
• Fix Show Character Name In Line View issue where the code still sets the text without the character name #121 - Logic for showCharacterNameInLineView was inaccurate versus its comments

https://yarnspinner.dev/blog/yarn-spinner-3-1-release/
https://yarnspinner.dev/blog/yarn-spinner-3-2-release/

Unity diff reference

YarnSpinnerTool/YarnSpinner-Unity@v3.0.3...v3.2.2

[dogboydog]

I think we are at the point where I invite anyone willing to test out the PR and let me know any issues as I would like to target releasing this new version soon