ノベルモード DRAFT

ノードの種別を novel に設定すると、通常の背景メディア（動画・画像）の上に重ねて原稿テキストが表示されます（オーバーレイ表示。背景メディアは置き換わりません）。背景を活かしつつ、小説・ビジュアルノベル的なテキスト送りを構成できます。

WARNING

ノベルモード機能は現在 DRAFT 段階です。ルビ・縦書き表示、音声との自動同期などは未対応で、今後の拡張候補として検討中です。

作成・紐付け

ノードパネルの「種別」を novel に切り替えると、📖 ノベルセクションが表示されます。「＋ 新規作成して紐付け」で新規原稿を作成するか、既存の原稿・セグメントから選択して紐付けます。原稿はセグメント単位（「ノードを区切る」で分割、「結合」で直前と結合）で管理し、キャンバス上部の原稿タブで本文を編集します。

JSON出力/読込 v1.204〜

原稿タブのタイトル欄の右にある 「📤 JSON出力」 で、その原稿（タイトル・表示設定・全セグメント）を1つのJSONファイルとしてダウンロードできます。セグメント本文は [voice:] / [bgm:] 等の記法込みのプレーンテキストのまま含まれるため、外部エディタでの編集や、AIによる生成の入出力フォーマットとしてもそのまま使えます。

「📥 JSON読込」 でJSONファイルを選ぶと、確認ダイアログの後にその原稿へ反映されます。既存セグメントと同じ id が含まれていればそのセグメントを更新（ノードからの紐付けを維持）、無ければ新規セグメントとして追加します。

WARNING

読込は確認後、原稿の内容を上書きします。元に戻せないため、必要であれば事前に現在の内容をJSON出力でバックアップしておいてください。

本文の記法

記法	内容
# / ## / ###	見出し（行頭に付ける。記号自体は表示されず、見出しの大きさは個別に設定可能）
---	罫線のみの行
>> / << / ==	その行だけ右／左／中央揃えに上書き（原稿ごとに初期の揃え方向を設定可能）
⏸（「ページを区切る」で挿入）	ページ区切り。この記号の数がそのままページ数になる（自動でのページ判定はしない）
//	行頭に付けるとその行はコメント（著者メモ）になり、再生時は表示されない
[wait:500]（「待ち時間を挿入」で挿入）	次の行が表示される前にミリ秒単位で待つ。数値は直接編集可能
[voice:URL]（「ボイスを挿入」で挿入）	直後の行に紐付くボイス（音声ファイルのURL）。詳細は下記「ボイス」参照
[bgm:URL] / [bgm:off] / [bgm:on]（「BGM切替を挿入」で挿入）	そのページが表示された瞬間にBGMを切り替え／停止／元に戻す。詳細は下記「BGM切り替え」参照

ボイス v1.203〜

行の直前に [voice:URL] を置くと、その行にボイス（音声ファイルのフルURL。ファイル名だけでは解決できない）を紐付けられます。1ページ内に複数のボイス付き行があれば、記載順に直列再生されます（1本再生完了→次を再生）。ページ内の全ボイスが再生し終わるまで、次のページ／次のノードへの進行（タップ・▼・選択肢ボタン）はブロックされます。 ボイスの無い行は通常通り待たずに表示されます。音量は固定100%です。

TIP

一部の重要な台詞だけにボイスを当てる、部分的な運用を想定しています。全行にボイスを付ける必要はありません。

BGM切り替え v1.203〜

ページ本文中に [bgm:URL] を置くと、そのページが表示された瞬間にBGMをそのURLへ切り替えます（ループ再生）。[bgm:off] で停止、[bgm:on] でこのノード本来のBGM設定（ノードパネルのBGM欄で設定したもの）に戻せます。ボイスと異なりブロッキングはせず、鳴らしながら自由にページ送りできます。

WARNING

ノードを跨いで移動すると、原則としてそのノード本来のBGM設定に戻ります。[bgm:off] でも、次のノードにBGM設定があればノード最初のページで再生が始まります。[bgm:off] をノードの先頭ページに置いておけば、そのタイミングで即座に無音に上書きできます（後から [bgm:on] や [bgm:URL] で任意のタイミングで鳴らす、という演出に使えます）。

表示設定

• 文字サイズ・1行の文字数・最大行数：折り返しはブラウザ標準に任せる方式（JS側で行数を計算しない）。最大行数を超えるページがあると⚠で警告表示（自動追加はしない）
• 画面にフィットさせる：ONの場合、本文表示エリアはテキスト位置から画面下端まで動的に伸びる
• タイプライター表示：ONで本文を1文字ずつ表示。タップで全文表示にスキップ可能（ONの間は3D表示演出は使用されない）
• 表示演出（3D傾き）：X/Y/Z軸それぞれに開始・通常・終了角度、アニメーション時間、イーズイン/アウトを設定可能。前ページの退出と次ページの入場は同時に重ならないよう制御される
• 背景板を非表示 v1.203〜：ONにすると本文の半透明パネルを消し、代わりに文字に影を付けて可読性を確保します（背景メディアが設定されている場合のみ効果あり）。影の**濃度（%）・角度（°、0=右/90=下/180=左/270=上）・ぼかし（%）・距離（px）**を個別に数値調整できます。

ページ送りと選択肢

本文の続きが表示領域を超えている間は↓アイコンが表示され、末尾まで読み終えると▼または選択肢ボタンに切り替わります（tap / page トリガーで送る構成が基本）。選択肢は本文直後に表示され、画面下部の汎用選択肢HUDとは重複表示されません。選択肢ボタンの見た目は表示テキスト／矢印プリセット／画像モードのいずれも動画モードと同じ優先順位で反映されます。

ノードを跨ぐ遷移（tap / timer / page トリガーによる次ノードへの移動）は、退出フェードが完全に終わって画面が一度黒くなってから切り替わります。同一ノード内のページ送りは黒くならず、通常のフェード演出のみです。

選択肢タップ後の挙動は、ノードパネルの「選択後に確認表示を出す」チェックボックスで切り替えられます。

設定	挙動
OFF（デフォルト）	タップと同時に効果音が鳴り、即座に次のノードへ遷移
ON	タップした瞬間に効果音は鳴るが遷移はせず、選んだ内容を吹き出しで反芻表示。▼が出た状態でもう一度タップすると遷移（誤タップ防止用）