Yarn Spinner 入門
最終更新：
orika_ex_miyako 2026年03月25日(水) 10:00:04履歴
はじめに 
Unityでノベルゲームや会話システムを実装する際に便利なツールとしては「宴(うたげ)」や「Fungus(ファンガス)」が有名ですが、その他にも「Yarn Spinner(ヤーン・スピナー)」があります。
Yarn Spinner は Fungus と同じく無料で公開されているオープンソースライブラリです。
Yarn Spinner 公式URL
https://docs.yarnspinner.dev/
Yarn Spinner のバージョンアップに伴い、2026年3月現在では
* OptionView（旧UI） * 古いAPI
などが存在せず、多くのネット記事との違いに戸惑うケースも少なくありません。
本記事では、最新版の Yarn Spinner（Option Presenter ベース）を前提に、
・Yarn Spinner とは何か ・Unityへの導入方法 ・最小構成での動作確認 ・基本的なスクリプトの書き方
を、初心者でも理解できる形で解説します。
動作環境
・Unity 6000.3.10f1 ・Yarn Spinner 3.1
Yarn Spinner とは？
Yarn Spinner は、Unityで会話・ストーリー分岐システムを実装するためのツールです。
特徴
・シナリオをテキストファイル（.yarn）で記述できる ・分岐・選択肢が簡単に書ける ・C#と連携可能（コマンド・関数） ・データドリブン設計に向いている(ロジックとビューの分離化)
シナリオファイルについてはノードビュー(フローチャート化)もされ、シナリオ修正すると即反映されるので、分岐処理などの修正を確認しやすい構造にもなっています。
参考サイト
Qiita @amenone_games(アメノネ ゲームズ) 様
【Unity用】ノベルゲーム・アドベンチャーゲーム制作ライブラリYarn Spinnerを使ってみた その1
https://qiita.com/amenone_games/items/c01bb5c1e62d...
Unity への導入手順
��Package Manager から導入
1. Unityを開く 2. Package Manager を開く 3. 「+」 → Git URL から追加
下記の Git URL を利用してください。
https://github.com/YarnSpinnerTool/YarnSpinner-Uni...
�⇒�用するコンポーネント
導入後、以下のコンポーネントが使用可能になります。
・Dialogue Runner ・Line Presenter ・Options Presenter
なお Yarn Spinner 公式サイトにも導入手順が公開されています。
Installation for Unity
https://docs.yarnspinner.dev/yarn-spinner-for-unit...
重要：旧UIとの違い
以前とは名称や役割が異なっているものがあります。
| 旧 | 新 |
| LineView | LinePresenter |
| OptionView | OptionsPresenter |
👉 現在は Presenter ベースでの動作になっています
最小構成(シーン)
Unity 内の Packages 内に YarnSpinner フォルダが追加されています。
その中の Prefabs フォルダにある Dialogue System プレハブをヒエラルキーにドラッグアンドドロップしてください。
ヒエラルキー画像
Dialogue System は下記のような構造になっています。
Canvas ├ Dialogue System(DialogueRunner アタッチ) │ ├ LinePresenter │ └ OptionsPresenter
こちらのゲームオブジェクトにアタッチされているコンポーネントにより Yarn Spinner は実行されます。
DialogueRunner 設定
DialogueSystem プレハブにアタッチされている、Yarn Spinner のメインとなるコンポーネントです。
Yarn Project を設定することで、ストーリーを展開します。
Dialogue Views に以下を登録することで会話ウインドウ、分岐ウインドウを表示させます。
LinePresenter OptionsPresenter
Yarnファイルの作成
シナリオ用のファイルです。拡張子が .yarn になっています。
こちらにシナリオを記述していくことで会話シーン、分岐などを作成します。
例：`MemeoryGame.yarn`
title: Start
----
ナレーション: これはテストです。
-> 次へ進む
ナレーション: 成功しました！
===
Yarn ファイルのアサイン
ヒエラルキーにある Dialogue System ゲームオブジェクトを選択し、インスペクターの Yarn Project 部分に、作成した Yarn ファイルをアサインしてください。
これで Yarn ファイルのシナリオを認識してゲーム内で再生させることができるようになります。
実行用スクリプト
デバッグ用の最小限の Yarn Spinner 実行用のスクリプトです。
実際の運用には Start メソッドの代わりに、PlayDialogue メソッドを実行して再生させるように変更してください。
using Yarn.Unity; の宣言が必要になります。
GameStarter.cs
using UnityEngine;
using Yarn.Unity;
public class GameStarter : MonoBehaviour
{
[SerializeField] private DialogueRunner dialogueRunner;
[SerializeField] private string startNodeName = "Start";
void Start()
{
// デバッグ用
dialogueRunner.StartDialogue(startNodeName);
}
/// <summary>
/// Yarn Spinner の DialogueRunner を利用して会話シーンの起動
/// </summary>
/// <param name="nodeName"></param>
public void PlayDialogue(string nodeName){
dialogueRunner.StartDialogue(nodeName);
}
}
スクリプト作成後、ヒエラルキーに Create Empty でゲームオブジェクトを作成し、名称を GameStarter に変更して、
こちらのスクリプトをアタッチしてください。
dialogueRunner 変数にはヒエラルキーにある DialogueSystem ゲームオブジェクトをドラッグアンドドロップしてアサインしてください。
アタッチされている DialogueRunner コンポーネントがアサインされます。
startNodeName 変数に指定している文字列が Yarn ファイル内の実行するタイトル名になります。
Yarn ファイル例
title: Start // ← これです。
----
ナレーション: これはテストです。
-> 次へ進む
ナレーション: 成功しました！
===
動作検証とデバッグ
ゲームを再生して動作検証とデバッグを行います。以下のように進んでいけば問題ありません。
１．会話ウインドウが画面に表示され、「ナレーション: これはテストです。」というテキストが表示される ２．ウインドウをクリックすると「次へ進む」選択肢が会話ウインドウ内に出る ３．「次へ進む」クリックで、「ナレーション: 成功しました！」という分岐先のテキストが表示される
Yarnの基本構文
ノード
以下のような形式になっているブロックを「ノード」と呼びます。
一連のメッセージや分岐までを含めて作成することが多いです。
title: Start ---- 内容 ===
この形式を守って作成することで、複数のノードを作成できます。
title に見合った内容で複数のノードを作成していくことでシナリオを作成していきます。
選択肢
-> と記述することで選択肢になります。
改行してメッセージを記述することで、その選択肢を選んだときのメッセージを作成できます。
-> 選択肢A
ナレーション: Aです
-> 選択肢B
ナレーション: Bです
この例であれば、選択肢A と選択肢B が画面に表示され、いずれか1つを選択すると
ナレーションのメッセージが流れます。
ジャンプ
<<jump ノード名>> と記述することで、指定されている title のノード(ブロック)にジャンプします。
<<jump NextNode>>
この例であれば NextNode という title のノードに移動します。
関数呼び出し
指定した関数を実行します。
{my_function()}
コマンド呼び出し
Yarn Command の属性が付与されている自作メソッドを実行します。
主に自作クラス内にある自作メソッドを呼び出す際に利用します。
自作クラスの設定
[YarnCommand("my_command")] // 属性を付与
public static void MyCommand(){
Debug.Log("Hoge");
}
実行時
<<my_command>>
引数を渡すことも可能です。
なお、static ではないメソッドを実行する場合には、実行コマンド名＋ゲームオブジェクト名が必要になります。(インスタンス参照が必要)
関数とコマンドについては公式サイトのドキュメントも確認しておいてください。
Yarn Spinner 公式ドキュメント
Commands and Functions
https://docs.yarnspinner.dev/yarn-spinner-for-unit...
注意点（重要）
�．螢鵐�機能は使わない方が良い
[[次へ|Next]]
👉 選択肢扱いになるため、UI依存で動かないケースあり。基本は jump を使う
<<jump Next>>
�∩�択肢は -> を使う
-> 次へ
<<jump Next>>
��title の書き方
title: Test ← OK title:Test ← NG
： とタイトル名の間には、半角スペースが必要です。
よくあるハマりポイント
�〜�択肢が表示されない
原因：
・OptionsPresenter が未設定 ・DialogueRunner に OptionsPresenter が未登録 ・Yarn ファイルの選択肢設定が間違っている
�▲灰泪鵐匹�呼ばれない
Yarn Command を実行する場合、static メソッド以外はコマンドの実行時にオブジェクト名が必要になります。
原因：
static メソッドで定義していない static メソッドではない場合、対象となるオブジェクトが見つからない
MonoBehaviour を継承しているクラスを利用していて、実行したいメソッドが static メソッドではない場合、そのクラスをアタッチしているゲームオブジェクトの名称をコマンドと一緒に書きます。
<<my_command GameStarter>>
��リンクが動かない
👉 仕様（選択肢扱い）
jump を利用してください。
まとめ
・Yarn Spinner はシナリオ制御に強力 ・最新版は Presenter ベース ・-> と <<jump>> が基本 ・UIと構文の理解が重要
おわりに
Yarn Spinner はシンプルに見えて奥が深く、
・UI構成 ・コマンド設計 ・データ分離
など、設計力が問われるツールでもあります。
ただし基礎を押さえれば、非常に強力なシナリオシステムになります。
まずは本記事の内容をベースに、簡単な会話システムを作ってみてください。
コメントをかく