Project

NarraLeaf Project は、創作から配布までの明確な道筋を持つ、ビジュアルノベル体験を構築するためのエコシステムです。ゼロコードの Studio、デスクトップアプリケーションのツールチェーン、軽量な React プレイヤーを 1 つにまとめており、チームはより広い NarraLeaf Project のモデルから外れることなく、適切な出発点を選べます。

このプロジェクトは、軽量な Web 技術、構造化されたコンテンツ、そして個人のプロトタイプから継続的に保守されるソフトウェアプロジェクトへと成長できるワークフローを中心に設計されています。制作者はシーンと物語の流れに集中でき、開発者は TypeScript、バージョン管理、パッケージング、アプリケーションレベルのカスタマイズへのアクセスを保ち続けられます。

プロジェクトの理念

NarraLeaf Project は単なる製品の一覧ではありません。ビジュアルノベルの制作が規模を増しても理解しやすいままであるための、プロジェクトの構造です。

このエコシステムが重視しているのは次の点です。

• 創作ツール、ランタイムの挙動、レンダリング、プレイヤー統合を明確に分離すること。
• 既存の開発ワークフローに馴染む、Web と TypeScript の基盤であること。
• プロジェクトのファイルとツール群が、現代的なソフトウェアと同じようにレビューされ、バージョン管理され、テストされ、出荷できること。
• 複数の入口を用意しつつ、それらが無関係な製品になるのではなく、同じ方向性を共有すること。

これにより、プロジェクトはビジュアルなワークフローから始め、必要になればデスクトップでの配布に関する事柄に踏み込み、あるいはプレイヤー層だけを既存の React 製品に組み込む、といった進め方が可能になります。

主な道筋

NarraLeaf Studio

NarraLeaf Studio は、ゼロコードでの創作と編集の道筋です。ガイド付きのビジュアル環境を通じて、ストーリー構造、シーン、制作ワークフローを組み立てたい制作者やチームを対象としています。

アプリケーションの内部を扱うより先に、コンテンツの創作と保守が最優先の課題である場合、Studio が最も適した出発点です。

NarraLeaf Desktop

NarraLeaf Desktop はデスクトップアプリケーションのツールチェーンです。NarraLeaf Desktop アプリケーションを構築し配布するためのランタイム、renderer、CLI をカバーしています。

この道筋は、ローカル開発、パッケージング、ランタイム統合、配布ワークフローを含め、アプリケーション全体を制御する必要がある開発者を対象としています。

NarraLeaf-React

NarraLeaf-React は軽量な React プレイヤーの道筋です。ビジュアルノベル体験を Web 製品に組み込みたい、あるいはプレイヤーの UI を深くカスタマイズしたいチームを対象としています。

この道筋では、プレイヤーを React エコシステムに近い形で保てるため、ストーリー体験がより大きなアプリケーションの一部である場合に有用です。

どこから始めるか

まずストーリーのコンテンツを作成し、シーンを管理し、ビジュアルな制作フローで進めていくことが最初の目標であれば、NarraLeaf Studio から始めてください。

完全なデスクトップ版のビジュアルノベルアプリケーションを構築しており、ランタイム、renderer、CLI、配布ワークフローへのアクセスが必要であれば、NarraLeaf Desktop から始めてください。

すでに React アプリケーションを持っている、軽量なプレイヤーが必要である、あるいは周辺の UI と製品体験を自分たちで管理したいのであれば、NarraLeaf-React から始めてください。

これらの道筋は、同じプロジェクトエコシステムの中で互いに両立するように設計されています。チームは 1 つの道筋から始め、プロジェクトがより技術的に、より協働的に、あるいはリリースに近づくにつれて、別の道筋を取り入れていくことができます。

マイルストーン

プロジェクト

• 2024 年 8 月 10 日：NarraLeaf Project が発足しました。
• 2024 年 9 月：NarraLeaf-React を npm で公開しました。React プレイヤーの最初の一般公開リリースです。
• 2025 年 2 月：NarraLeaf のデスクトップツールチェーンを公開しました。ストーリーをデスクトップアプリケーションとして配布できます。
• 2025 年 10 月：NarraLeaf のコマンドラインツールを公開しました。プロジェクトの作成、ローカル開発、ビルドに対応します。
• 2026 年 5 月：narraleaf.com を公開し、3 つの道筋のドキュメントを 1 か所にまとめました。
• 2026 年 8 月：NarraLeaf Studio が最初の一般公開リリースに達しました。プロジェクトは Windows、macOS、Android、iOS、Web に向けてビルドできます。

0.1.0 より前

Studio の基礎の大半は、最初のバージョンに至るまでの 10 か月で作られました。この時期のプロジェクトにはまだバージョン番号がありません。

• 2025 年 10 月：プロジェクトの開始です。ウィンドウとプロセスの層、ファイルシステム、ランチャー、新規プロジェクトのウィザードができました。
• 2025 年 11 月：ワークスペースの形が決まりました。可変のパネル、サイドバー、モジュールとフォーカスの仕組み、そして最初のアセットライブラリーです。
• 2025 年 12 月：外観・差分・グループを扱うキャラクターエディター。続いて設定パネルとリモートアセットが加わりました。
• 2026 年 1 月：UI エディターに着手しました。アセットライブラリーにアイコン表示、コピーと貼り付け、ロックが入りました。
• 2026 年 2 月：UI エディターが使える状態になりました。サーフェス、プロパティエディター、画像の切り抜き、カラーピッカーが揃い、Dev Mode が現れます。
• 2026 年 4 月：ブループリントの仕組みです。ノードグラフのエディター、診断、メンバーパネル、変数の管理が入りました。
• 2026 年 6 月：ストーリーエディターに着手しました。ブループリントがサーフェスのスコープと履歴を持ち、アセットとウィンドウへのアクセスを見直しました。

Studio のリリース

• 0.1.0（2026 年 7 月）：最初のバージョンです。コマンドパレット、ショートカットの割り当て、通知センター、プラグインの仕組み、ギャラリーが同時に加わり、プロジェクトはデスクトップ・モバイル・Web に向けてビルドできます。
• 0.1.1：ヘルプメニューに「バージョン情報」を追加しました。
• 0.2.0：PSD から取り込むレイヤー立ち絵、差分ごとの会話用アバター、1 枚のマスターアイコンから 6 つのターゲット向けに焼き上げるアイコン、権限で制御されるランタイム API を伴うプラグインのサイドカーに対応しました。
• 0.3.0（2026 年 8 月）：ダウンロードを公開した最初のリリースです。Live2D と Spine のモデルを案内付きで取り込み、キャラクターごとにバスを立てられる音声ミキサー、プロジェクト検査、コード署名と公証、世代を回す自動セーブに対応しました。
• 0.4.0：ストーリーエディターのコマンド語彙を統一し、確定した行はそれを書いた行としてそのまま読み戻せます。ヘルプが Studio の内部に入り、翻訳者のツールが読める形式で書き出せます。
• 0.5.0：インストーラーと、GitHub Releases からの自動更新。取り込み時に再生できるかを検査し、変換を提示します。ブループリントのブレークポイントと Dev Mode のデバッガー、色がプロジェクトのパレットを参照できる仕組みも入りました。
• 0.6.0：ビルドの変種です。変種はパッケージの内容とストーリーの終わり方を宣言し、ビルドは何を落としたかを報告します。ブループリントのエディターは独立したウィンドウで開き、プロジェクトは自前の辞書を持ちます。
• 0.7.0：アセットセットです。1 つのライブラリー項目が一群のファイルを代表し、実行時には言語で、ビルド時にはリリースで解決されます。作者が作るパッチと、それを読み込む出荷済みのゲーム、天候、スキップと自動送りの待ち時間も加わりました。
• 0.8.0：カタログに照らしてブループリントをテキストで書けます。キャンバスのツールバーとグラフの全体表示、コマンドラインからのビルド、独立したファイルとして書き出す DLC、ビルドごとの内容レポートに対応しました。
• 0.9.0：ライブセッションです。ホストが部屋を開き、セッションが運ぶファイルはそのセッション自身の接続を通ります。トラックごとの圧縮、保護対象の作品に合わせてコーデックをコンパイルする保護付きビルド、ビルドが生成するすべてのターゲット向けのプラグインサイドカーも入りました。
• 0.9.1：プロジェクトの書き出しがパッケージ済みのビルドに対応し、大きなパッケージは分割して読み書きします。
• 0.9.2：セーブはそれが書かれたストーリーの中で開きます。シーンは画面をページに返せます。トランスフォームのプリセットはファイルとして持ち運べ、翻訳表と音声表を検索できます。
• 0.10.0（2026 年 9 月）：スクリプトはブループリントのレイヤーになり、作者が自分のエディターで書く TypeScript ファイルがその中身です。Studio が知らないプロジェクトは、信頼されるまでビルドも実行もできません。キャラクターは自身のピクセルサイズで描かれ、コマンドラインでは --build に --test と --lint が加わりました。
• 1.0.0（2026 年 10 月）：最初の安定版です。0.10.0 のプロジェクトがエンジン 1.0 で動き、プラグインの型パッケージは Studio 自身のバージョン番号で公開されます。
• 1.1.0：プロジェクトのすべてのブループリントを 1 ページで見渡せる一覧、レイヤーのテンプレート集、要素のプロパティとしてのホバー音とクリック音に対応しました。テキストの文字は、自身の文字・翻訳キー・ブループリント値の三つから選びます。
• 1.2.0：プラグインのストーリーアクション、/play を通してのみ登場する動画、Windows 上での macOS と Linux のパッケージのビルド、ホバーすると反対側の端を示すワイヤーに対応しました。
• 1.3.0：ページ上のテキストは文字の出どころを一つだけ持ち、キャンバス・ゲーム・翻訳・検索のどれもが同じように読みます。プロジェクト検査はバックグラウンドで動き、結果を Problems（問題）パネルに並べます。
• 1.4.0：ページのパラメータ、ブループリントのピンに付く構造体の型、入力アクションへのゲームパッドの割り当て、インターフェースエディターのグリッド、作者が決めるストーリーコマンドの略語に対応しました。
• 1.4.1：コンポーネントのルートをそのエディターで差し替えられます。子要素は、コマンドを開いた行の中に挿入されます。
• 1.4.2：ライブプレビューはプレビュー中の行でのセーブ変数の値を表示します。ゲームの中の Studio 自身の文言はゲームの言語に従い、コンポーネントのパラメータに音声トラックを持たせられます。
• 1.4.3：アップデートはバックグラウンドで自動的にダウンロードされ、適用の準備まで済みます。タイトルバーのアップデートボタンが進み具合を示し、/rename 行が付けた名前は翻訳できます。
• 1.4.4：各リリースが GitCode にも複製され、中国本土からもダウンロードとアップデートができます。Windows のインストーラーは通常の大きさに戻りました。
• 1.4.5：失敗したアップデートのダウンロードは自動的にやり直され、別の取得元があればそちらから取得します。アップデートパネルは何がうまくいかなかったかを示します。
• 1.5.0：作者自身の AI エージェントが開いているプロジェクトでゲームを作れます。ゲームはキーボードやゲームパッドだけで遊べます。シーンのレイヤーはカメラからの距離で配置します。ストーリーモーションエディタを作り直しました。プロジェクトの検査に軽微な警告のレベルが加わりました。
• 1.6.0：パレットでは同じ種類のブループリントノードが 1 行にまとまり、配置したカードはタイトルの横から同じ種類の別のノードに切り替えられます。Equal（等しい）と Not Equal（等しくない）は値で比較します。パレットの分類ごとにアイコンが付きました。ノードの type id は開発者オプションがオンのときだけ表示されます。
• 1.6.1：Windows で stdio 経由の AI エージェントが接続できるようになりました。設定のアクセストークンをコピーできます。入力メソッドがオンのままでも、ストーリーエディターで / と # からコマンドを始められます。ブループリントのレイヤーは開いた時点で表示範囲に収まっています。
• 1.6.2：Claude Code のエージェントがシーン、ページ、ガイドの章を全文読めるようになりました。エージェントが UI 要素に設定した文字サイズや色がページに反映されます。.story ファイルの短い /if と別名で書いた話者が、エディターと同じように扱われます。設定にエンドポイントのポートが戻り、使用中のポートは別のポートに替えずにエラーとして示します。
• 1.6.3：ページが自分の音楽を再生できるようになり、シーンの音楽と同じ方法で設定します。同じ音楽はページをまたいでも途切れません。「ファイルを差し替え…」、PSD の取り込み、音声の取り込みを元に戻せます。検索パネルの「すべて置換」は一度で元に戻せます。エージェントが接続しただけでは Studio が起動しなくなりました。Live2D と Spine のキャラクターがステージの比率で描かれます。「ログ」ページに、各セリフを言ったときの顔が表示されます。

エコシステムの方向性

NarraLeaf Project は、アセットのパッケージング、音声、UI 構築、スクリプト、制作ワークフローを支援するツール群を中心にも成長を続けています。これらのツールは、独立した製品の縦割りを作るのではなく、3 つの主な道筋を支えることを目的としています。

長期的な目標は、ビジュアルノベルのプロジェクトのために一貫したツールセットを提供することです。制作者にとって親しみやすく、開発者にとって実用的で、実際のアプリケーションを保守し出荷する必要のあるチームを支えられるだけの構造を備えたものです。