StageTimelineTools Builder

StageTimelineConfig に記述した公演設定（シーン・幕場の区切り・プリセット・演出指示）から、TimelineAsset・AnimationClip・設定バックアップを生成し、StageTimelineManager へシーン境界・配役・ワープ・連動イベントを書き込むエディタ拡張。Q シートウィンドウ（Q シート・遷移表・CSV 出力）、設定バックアップからの復元、外れた参照の再割り当てを持つ。ランタイムの仕様は StageTimelineTools に記載する。

構成

• 名前空間: Runtime/ は MashiroTheater.StageTimeline.Builder、Editor/ は MashiroTheater.StageTimeline.Builder.Editor。

依存

仕様

エディタウィンドウ

• メニュー: Tools/Mashiro Theater/Stage Timeline Builder。タイトル Stage Timeline Builder、最小サイズ 760×560。
• ウィンドウを開いたとき・アクティブシーンを切り替えたときに、アクティブシーン内の StageTimelineConfig を検索して読み込む。
• 描画時に StageTimelineConfig.UpgradeBuilderDataIfNeeded() を呼ぶ。
• setupCompleted が false の間は初期設定画面のみを表示し、タブを表示しない。
• ツールバー:

初期設定

• Config が無い、または title が空の場合: 「公演名」入力欄と「はじめる」を表示する。Config が無い場合は「作成済みの Config を使う」（Config 欄・「シーンから読み込み」）も表示する。
• 「はじめる」（Enter キーでも可）:
  • Config が無い場合は下記「Config の作成」を行う。
  • title が空の場合のみ、入力した公演名を title に設定する。
• 続けて 3 ステップを表示する: 1「出力先」（出力先フォルダ）/ 2「登場人物」（characters）/ 3「高度な機能」（機能スイッチ）。
• stageTimelineManager が未設定の場合、フッターに「StageTimelineManager が未設定です（設定タブで指定できます）」を表示する。進行は妨げない。
• 「完了」で setupCompleted = true にし、設定タブに完了案内を表示する。

Config の作成:

1. アクティブシーンに StageTimelineConfig が既にある場合は作成せず、それを読み込む（ダイアログを表示）。
2. GameObject StageTimelineConfig を作成し、StageTimelineConfig を追加して InitializeAsNewBuilderData() を呼ぶ。
3. シーン内の StageTimelineManager を検索する。無い場合は StageTimelineManager.prefab（GUID d6039a8e2ad4bb94ebb38f0482116a81 で参照）をシーンのルートに配置する。Prefab が見つからない場合は Warning。
4. Manager がある場合:
   • Config の GameObject を Manager の子にする。
   • stageTimelineManager に Manager を設定する。
   • Manager 配下で名前に 暗転Box または 暗転用オブジェクト を含む GameObject を blackoutBoxRoots に、暗転中ガイド を含む GameObject を blackoutGuideRoots に追加する。
5. blackoutBoxRoots が空の場合は未割り当ての要素を 1 つ追加する。

• title を変更すると、GameObject 名が StageTimelineConfig - {タイトル}（タイトルが空なら StageTimelineConfig）に追従する（変更前の名前がこの形式と一致している場合のみ）。

設定タブ

左の一覧でページを切り替える。必須項目が空のページには橙の点を付ける。

機能スイッチ:

• スイッチは表示のみを切り替える。OFF でもデータは保持し、生成に反映する。

「Config を初期化…」（左の一覧の下）:

• Config がプレハブインスタンスに含まれる（追加コンポーネントのオーバーライドでない）場合は実行しない。
• 確認ダイアログの後、全項目バックアップ（種類 BeforeInitialize）を書き出す。書き出せない場合は中止する。
• Config コンポーネントを削除して追加し直し、InitializeAsNewBuilderData() を呼ぶ（Undo 1 回で戻る）。
• GameObject 名が StageTimelineConfig で始まる場合は StageTimelineConfig に戻す。
• シーン内の StageTimelineManager を stageTimelineManager に設定し、暗転オブジェクトを Config の作成と同じ規則で登録する。
• シーンに配置したワープ地点は削除しない。

プリセットタブ

• 左の一覧: 照明 / オブジェクト / アニメーション / BGM / SE。showAnimatorFeatures ON で Animator パラメータ / Animator トリガー、showUdonEventFeatures ON で Udon イベント、showPostProcessFeatures ON でポストプロセスを追加表示する。カメラのプリセットはカメラタブで扱う。
• 各カテゴリに参照切れのプリセット数を表示する。

• 対象を割り当てたとき、表示名が空なら対象の名前を表示名に入れる。
• ツールバー: 検索、絞り込み（すべて / 未使用 / 参照切れ）、「⚠ 参照切れ N」（参照切れの絞り込みを切り替える）、「この順番で保存」（見出しで並べ替えた表示順を保存順にする。番号順以外で並べ替えている場合のみ表示）。
• 行の「⋯」メニュー: 「デフォルト設定を反映」（照明・BGM・SE のみ）/「複製」（新しい id を採番して直後に挿入）/「削除」（使用中の場合は使用数を示して確認する）。
• 表の下: 「＋ {カテゴリ}を追加」（ポストプロセスは「＋ Volume を追加」）。照明カテゴリのみ「LightGroup をスキャン」を併置する。
• ドラッグ＆ドロップ欄: Hierarchy のオブジェクトをまとめて追加する。表示名はオブジェクト名。登録済みの対象とカテゴリに合わない対象は除外する。

• 右の欄「使うシーン」: 選択中のプリセットを使用しているシーンを一覧する。
• ポストプロセスの行: GameObject に PostProcessVolume が無い場合、または Is Global でない場合に警告を表示する。Is Global でない場合は「Is Global にする」で isGlobal を ON にする。
• 「LightGroup をスキャン」: アクティブシーン内の MashiroLightGroup のうち、どの照明プリセットの lightRoot にもなっていないものを照明プリセットとして追加する（displayName = GameObject 名、defaultColor = MashiroLightGroup.initialColor）。
• 「デフォルト設定を反映」:
  • 照明 / BGM: そのプリセットを参照し、action が FadeIn、または Change かつ useDefaultValues が ON のエントリに、プリセットの既定値（照明: defaultIntensity / defaultColor、BGM: defaultVolume）を書き込む。BGM の Change + useDefaultValues エントリは pitch を 1 にする。
  • SE: そのプリセットを参照するすべてのエントリの volume に defaultVolume を書き込む。
  • 対象エントリが無い場合はダイアログを表示して何もしない。

シーンタブ

左にシーン一覧、右に選択したシーン（または区切り）の詳細を表示する。

シーン一覧:

• ツールバー: 検索、「絞り込み」（詳細に表示する演出カテゴリの切替・「すべて表示」・「すべて隠す」）、一覧を閉じるボタン（閉じた状態では前後のシーンへ移動するボタンを表示）。
• フッター: キュー数（Cue N）、「＋ シーン」（末尾に追加）。
• ドラッグで並べ替える。統合されたシーンはまとめて移動する。
• 右クリック（詳細の「⋯」も同じ）メニュー:

シーン詳細:

• 演出はカテゴリごとの表に表示する。表は「このシーンで追加した演出」と「前のシーンから継続中の演出」（「#N から」の行）を含む。
• 参照切れのエントリは行に警告を表示する（判定は StageTimelineReferenceValidator）。
• フッター: 警告の要約（⚠ 警告 N 件（シーン #…））または生成を妨げる条件の 1 件目、「タイムライン生成」。

演出の追加（「＋ 演出を追加 ▼」→ カテゴリ、または各表の追加ボタン）:

• プリセット選択は bindingMode = Preset、自由指定は bindingMode = Direct。
• 照明・オブジェクト・BGM は、前のシーンから継続中の対象と、このシーンで既に追加した対象のプリセットを選択肢から除く。
• 暗転は、前のシーンから暗転中の場合と、このシーンに FadeIn がある場合は追加できない。
• ポストプロセスは 1 シーン 1 件まで追加できる。
• ワープの行の「新規作成」はワープ地点を作成して destinationTransform に設定する（下記「ワープ地点と Gizmo」）。

幕・場の区切り

• sceneDividers の各要素（SceneDivider）は、すぐ下のシーンを sceneUid で指す。シーンの並び・番号・タイムラインには影響しない。
• 区切りの用途: シーン一覧の表示、Q シートウィンドウのページ分け、Q シート CSV の 幕 / 場 列。
• 追加: シーンの右クリックメニュー「この上に場の区切りを入れる」/「この上に幕の区切りを入れる」。統合グループの 2 番目以降のシーン、および同じ種類の区切りが既にあるシーンには追加できない。
• 番号: 区切りを上から並べ、同じシーンの上では幕を場より上にする。幕は通し番号、場は幕の区切りを越えるたびに 1 から振り直す。表記は N幕 / N場。
• 一覧の区切り行: クリックで選択、ドラッグで移動（統合グループの途中に移した場合はグループの先頭へ寄せる。移動先に同じ種類の区切りがある場合は移動しない）、右クリックで「名前を変える」/「削除」。
• 区切りの詳細: 表記、名前（name）、「削除」、「範囲」（場は次の区切りの手前まで、幕は次の幕の手前までのシーン番号）。
• シーンの並べ替え後も、区切りは並べ替え前と同じ行位置に残す（統合グループの途中になった場合はグループの先頭へ寄せる。同じシーンに同じ種類が重なった場合は削除する）。

カメラタブ

• showCameraFeatures が ON のときのみ表示する。
• cinemachineBrain が未設定の場合は「CinemachineBrain が未設定です。設定タブの「高度な機能」で割り当ててください。」を表示する。
• 左「カット割り」: シーンごとの CameraEntry。列は No / シーン / アングル / タイミング（最初 / 最後）/ 遅延 / ✕。タイミングが「最後」の場合、遅延は 0 にする。「＋ 切り替えを追加」と右クリックメニュー（切り替えを追加 / カットを追加 / このカットを削除）で編集する。
• 右「アングル」: cameraPresets。「＋ アングルを追加」、選択中のアングルの「Scene ビューで見る」（Scene ビューを vcam の位置と向きに合わせる）・「選択」（Hierarchy で vcam を選択）、「⋯」メニュー（複製 / 削除）、使用シーンの一覧。
• アングルの表示色は並び順で決まる（colorSlot は使用しない）。

タイムライン生成

• シーンタブの「タイムライン生成」で StageTimelineGenerator.Generate を呼ぶ。
• 押せる条件: stageTimelineManager 設定済み、title が空でない、シーン 1 件以上、閲覧モード OFF。
• 生成結果の Warning は Console に [StageTimeline] 付きで出し、続けて集計（TimelineBuildResult.LogSummary）を出す。

Generate の処理順:

1. stageTimelineManager が未設定ならシーン内を検索して設定する。
2. 適用先 PlayableDirector を解決する（下表）。解決できない場合は Error を出して終了する。
3. シーンが 0 件なら Error を出して終了する。
4. {出力先}/{タイトル} を作成し、要約バックアップ・参照の控え（referenceHints）・全項目バックアップ（種類 Generate）を書き出す。
5. Anim/ 内の既存アセットをすべて削除する。
6. 演出の計画・シーン尺を求め、トラック・クリップを書き込み、StageTimelineManager へ書き込む。
7. PlayableDirector に TimelineAsset を割り当て、再生位置を生成前の位置（全長内に収める）にする。Evaluate() は Timeline ウィンドウのプレビュー中（AnimationMode.InAnimationMode()）のみ行う。

適用先 PlayableDirector の解決順:

• 3〜5 で解決した場合は Manager の timeline に設定する。
• stageTimelineManager が未設定の場合は 1 のみ。

シーンとシーングループ

• autoAdvance が ON のシーンは次のシーンと同じシーングループになる。グループ内のシーン境界にはチェックポイントを置かない（自動で次のシーンへ進む）。
• グループの表示名 = 先頭シーンの sceneName（空なら シーン {グループ番号}）。
• グループの「次のキッカケ」 = 次のグループの先頭シーンの cue。
• チェックポイント = [0, グループ1の終了時刻, グループ2の終了時刻, …]（整数秒に切り上げ。直前の値以下の場合は直前 + 1）。

シーン尺

標準尺のシーン（useCustomDuration が OFF かつ durationSeconds が 0 以下）: 次の最大値。

秒数指定のシーン（useCustomDuration が ON、または durationSeconds > 0）:

• 尺 = durationSeconds（0 以下なら defaultSceneDuration）。
• 次の必要秒数の最大値が尺を 0.001 秒超える場合、尺をその値へ延長する。

• 延長時、入力秒数の最大値も尺を 0.001 秒超える場合は Warning を出す。
• SE・アニメーション Hold は延長の対象外。

共通:

1. 各シーン尺の下限は 0.1 秒。
2. 各シーンの終了時刻（累積）を整数秒へ切り上げる。結果として各シーン尺は 1 秒以上の整数秒になる。
3. タイムライン全長 = max(最終シーン終了時刻, SE・SingleShot アニメのクリップ終端の最大値) + 0.1。

生成物

• {出力先} = generatedBaseFolder。空、または Assets で始まらない場合は Assets/StageTimelineTools/Generated（後者は Warning を出す）。
• {タイトル} = title のファイル名に使えない文字を _ に置換した値（title が空の場合は Show）。
• 既存の .playable がある場合は、ルートの GroupTrack Generated のみを削除して作り直す。それ以外のトラック（ユーザー追加トラック）は保持し、そのクリップを前回生成時のシーン内相対位置へ移動する（所属シーンが削除された場合は、前回順で直前に残っているシーンの終了時刻、無ければ 0 秒）。
• TimelineAsset: フレームレート 60、DurationMode.FixedLength。
• PlayableDirector: playableAsset に生成した TimelineAsset、playOnAwake = false、extrapolationMode = Hold、timeUpdateMode = GameTime、initialTime = 0。
• 照明ルート・BGM / SE の AudioSource・暗転オブジェクト・ワープマーカー・ポストプロセス Volume の GameObject に Animator が無ければ追加する。
• BGM / SE の AudioSource の playOnAwake が OFF なら ON にする。
• ポストプロセスの対象 Volume の weight を 0 にする。

AnimationClip のファイル名（NNN はシーン番号 3 桁）:

生成トラック

すべてルートの GroupTrack Generated の下に作成する。

• Objects 〜 Cameras の GroupTrack は常に作成する。Post Process は対象 Volume がある場合のみ、Animator Params / Animator Triggers / Udon Events は対象がある場合のみ作成する。
• muted のトラックは表示用で、再生に影響しない。Animator パラメータ / トリガー / Udon イベントの実行は StageTimelineManager が行う。

発火タイミング

S = シーン開始時刻、E = シーン終了時刻、d = エントリの遅延秒数。

• 「最後」指定のワープ・カメラ・Udon イベントでは d を使わない。
• オブジェクト・ワープ・Animator パラメータ・Animator トリガー・Udon イベントの発火時刻はシーン範囲 [S, E] に収める。
• 「最後」指定のワープ・カメラ・Udon イベントで、シーン尺がリード時間より短い場合は Warning を出す。

リード時間定数:

• PostProcessMinFadeSeconds（1/60 秒、StagePlanning.cs）: ポストプロセスのフェード秒数の下限。フェード 0 秒は 1/60 秒のフェードになる。

演出ごとの仕様

• オブジェクト: 同一シーン・同一対象のエントリは先頭 1 件のみ有効。表示中の Appear・非表示中の Disappear は無視する。
• アニメーション:
  • Hold: 同じ対象の Stop またはタイムライン末尾まで再生する。再生中の対象に新しい Play がある場合は、そのシーン開始で前の再生を終える。
  • SingleShot: 次のシーン開始（最終シーンではシーン終了）までクリップを配置する。クリップ長がその区間より長い場合はクリップ全長（タイムライン末尾まで）配置する。
• 照明:
  • 対象は lightRoot 配下の Light と、シェーダー Noriben/noribenBeamLight のマテリアルを持つ MeshRenderer。
  • Light: m_Intensity / m_Color を、MeshRenderer: material._Intensity（強度 × 0.05）/ material._Color をアニメーションする。
  • 点灯区間外は対象 GameObject を非アクティブにする。
  • FadeIn は強度 0・色 (0,0,0,0) から、Change は現在値から目標値へ、FadeOut は強度を 0 へフェードする（色は変えない）。
  • 消灯中の Change は FadeIn として扱う。
• BGM: AudioSource.clip を再生する。FadeIn は音量 0 から、ピッチ 1 で開始する。音量は 0–1、ピッチは −3–3 に制限する。Change で区切られた区間の有効化は連続させる。
• SE: AudioSource.clip を 1 回再生する。音量は 0–1 に制限する。同じ AudioSource の次の SE と重なる場合は、前の有効区間を次の開始 1/60 秒前で切る。クリップがシーン終了を超える場合はタイムライン末尾まで延長する。
• 暗転:
  • 1 シーンにつき先頭 1 件のみ有効。暗転中の FadeIn・非暗転中の FadeOut は無視する。
  • blackoutBoxRoots 配下の各 Renderer のマテリアル _Color.a / _BaseColor.a（_Alpha プロパティがあればそれも）と、各 CanvasGroup の m_Alpha をアニメーションする。
  • blackoutGuideRoots は不透明度 1 の区間の前後 0.1 秒を含めて表示する。
• ポストプロセス:
  • 1 シーンにつき先頭 1 件のみ有効（2 件以上は Warning）。
  • 有効な Volume は常に 0 または 1 つ。presetId が空のエントリは「なし」（現在の Volume を外す）。
  • 切り替えは、前の Volume の weight を 1→0、次の Volume の weight を 0→1 へ同じ時刻・同じ秒数で線形に変化させる。
  • 直前と同じ Volume への切り替えはスキップする（Warning）。
  • 対象 Volume ごとに全シーン分のクリップを並べる。weight が一定のシーンが続く場合は 1 クリップにまとめる。最後のクリップは max(最終シーン終了 + 0.1, タイムライン全長) まで延ばす。
  • 対象は PostProcessVolume を持ち、Is Global の Volume のみ。
• ワープ:
  • StageTimelineManager に destinationTransform の position と eulerAngles.y を書き込む。
  • warpMarkerPrefab 設定時、生成物の親（下記）の子 _WarpMarkers にキャラクターごとのインスタンス WarpMarker_{番号2桁}_{キャラクター名} を作成・更新する。タグ EditorOnly、非アクティブ、色はキャラクター順の固定 10 色。ワープ時刻から 2.0 秒間表示する。
• カメラ:
  • 全シーンのカメラ指定を時刻順に並べ、各指定の切替時刻から次の切替時刻（最後はタイムライン末尾）まで、そのプリセットの virtualCamera の CinemachineShot を置く。
  • presetId が空の指定は無視する。
  • cameraPresets が空、または有効な指定が 1 件も無い場合は CinemachineTrack を作成しない（cameraPresets が空の場合は cinemachineBrain 等の Warning も出さない）。
  • CameraEntry の blendSeconds / FOV / チルト・パン関連フィールドと、CameraPresetEntry の activePriority / inactivePriority / defaultFov / colorSlot は生成に使用しない。
• Animator パラメータ / トリガー: 対象 Animator の AnimatorController（AnimatorOverrideController は元のコントローラー）に同名パラメータがあり、型が Int / Trigger であることを検証する。AnimatorController に解決できない場合は検証を省略する（Warning）。
• Udon イベント: 対象型に public・引数なしの同名メソッドが無い場合は Warning のみ出して生成する。ownerOnly は Preset 指定時は選択肢の値、Direct 指定時はエントリの値を使う。

生成物の親（ワープマーカー _WarpMarkers・ワープ地点 _WarpPoints）:

• 適用先 PlayableDirector の GameObject。適用先が無い場合は Config の GameObject。
• 適用先の下に同名の子が無く、Config の下に同名の子がある場合は Config の GameObject。

プリセットの参照方式

プリセットの id は GUID（N 形式）で自動採番する。エントリはプリセットを presetId で参照する。

• オブジェクト・アニメーション・照明・BGM・SE は、プリセットが見つからない場合にエントリの Direct 用フィールド（target / clip / lightRoot / source）を使う。
• Animator トリガー / Udon イベントは、ID で選択肢が見つからない場合、エントリの triggerName / eventName と同名の選択肢で解決する。
• 選択肢を解決できないエントリは Warning を出してスキップする。

StageTimelineManager への書き込み

stageTimelineManager 設定時、SerializedObject 経由で次を書き込む（未設定時は Warning を出して書き込まない）。

Warning / Error

Console に [StageTimeline] 付きで出力する。

Q シートウィンドウ

• ビルダーのツールバー「Q シート ↗」で開く。タイトル Q シート、最小サイズ 640×320。
• 表示対象は開いている Stage Timeline Builder の Config。Config の変更とビルダーで選択中のシーンに追従する（選択中のシーンを含むページを開く）。
• 1 キュー = 1 シーングループ。尺はシーン尺の計算（整数秒への切り上げ前）の合計。
• ツールバー: 「Q シート」/「遷移表」の切替、検索、「CSV を出力」（下記 CSV）。
• ページ: 幕・場の区切りで分ける。区切りが無い場合は 1 ページ。最初の区切りより前のキューは「はじめ」のページ。統合グループの途中にある区切りはそのキューの先頭にあるものとして扱う。ページ見出しは幕の区切りがある場合 A幕B場、無い場合 N場 / N幕。
• キューのクリックでビルダーのそのシーンを選択し、ダブルクリックでそのシーン（カメラはカメラタブ）を開いて演出の行を示す。

• 状態が変わらない操作（点いていない対象の消灯・点いている対象の点灯・鳴っていない BGM の Change）は区別して表示する。

Q シート CSV

Q シートウィンドウの「CSV を出力」で保存先を選んで出力する。読み込み機能は無い。

• 既定ファイル名: {タイトル}_QSheet.csv（タイトルが空なら QSheet.csv）。
• 文字コード UTF-8（BOM 付き）、区切り ,、行区切り CRLF、セル内改行 LF。空セルは -。
• 先頭行 # Stage Timeline Builder Export、続いて タイトル,… と 出力日時,yyyy-MM-dd HH:mm、空行、表。
• 列: Cue / 幕 / 場 / シーン / キッカケ / 照明 / 暗転 / BGM / SE / オブジェクト / アニメーション / ワープ / カメラ / 尺。
• 1 行 = 1 シーングループ。Cue はグループ番号、シーン はグループ内の sceneName を / で連結、キッカケ は先頭シーンの cue。
• 幕 / 場: そのグループの最後のシーンまでに現れた区切りのうち直近の幕・場の N幕 / N場（名前があれば半角スペースに続けて名前）。幕の区切りが 1 つも無い場合、幕 列は -。幕の区切りが現れると 場 列を空に戻す。
• 尺 はグループ内のシーン尺（タイムライン生成と同じ計算、整数秒への切り上げ前）の合計。書式 X.Xs。
• グループ内 2 番目以降のシーンの演出は、グループ先頭からの経過秒をオフセットに加える。
• 暗転 列は、そのグループに暗転エントリが無く暗転継続中の場合 暗転中。
• カメラ 列は showCameraFeatures に関わらず出力する。

セル内の 1 行の書式: [オフセット][タグ] 対象 フェード秒 付加情報

バックアップ

要約バックアップ:

• 生成のたびに StageTimelineConfigBackup.json を上書きする（JsonUtility、UTF-8）。読み込み・復元には使わない。
• オブジェクト参照は GlobalObjectId 文字列で記録する。
• 記録する項目: 出力日時、title、defaultSceneDuration、playableDirector、stageTimelineManager、暗転オブジェクト・ガイド、照明プリセット、カメラプリセット、ポストプロセスプリセット、cinemachineBrain、各シーンの sceneName / cue / 尺設定 / autoAdvance / オブジェクト / アニメーション / 照明 / BGM / 暗転 / カメラ / ポストプロセス。

全項目バックアップ:

• Config のシリアライズ対象をすべて EditorJsonUtility で書き出す。オブジェクト参照は instanceID に globalObjectId を添えて記録する。
• ファイル名: StageTimelineConfigBackup_{種類}_{yyyyMMdd_HHmmss}.json。
• 保存先: {出力先}/{タイトル}（title が空の場合は {出力先}）。
• 種類ごとに新しいものから 20 件（HistoryLimit）を残し、古いものを削除する。

設定タブ「バックアップ」:

• 「いまの内容をバックアップ」、「フォルダを開く」。
• 保存先の全項目バックアップを新しい順に一覧する（日時・種類）。
• 選択したバックアップの公演名・シーン数・プリセット数・登場人物数を表示する。読み込めないファイルは「このバックアップは読み込めません。」。
• 「このバックアップに戻す…」:
  1. 確認後、現在の内容を全項目バックアップ（種類 BeforeRestore）に書き出す。書き出せない場合は中止する。
  2. バックアップを一時的な Config に読み込み、設定値を現在の Config へ写す（GameObject と有効状態は変えない。Undo で戻せる）。
  3. オブジェクト参照は globalObjectId で現在開いているシーン・プロジェクトから解決できたもののみ戻し、解決できない参照は未設定にする。
  4. 戻した後に未設定の参照（下記「参照の再割り当て」の対象）がある場合は件数を示し、「参照の再割り当てを開く」を提示する。
• 「削除…」: 確認後にファイルを削除する。

参照の再割り当て

• 対象: Config 内のシーン内オブジェクト（GameObject / Component）への参照のうち、未設定のもの。SerializedObject で全フィールドを走査する。
• 対象外: m_Script、referenceHints、previousSceneSnapshots、warpMarkerPrefab、_deprecated*、プロジェクト内のアセット、ワープ（warps）の参照、bindingMode = Preset のエントリの参照。
• 一覧に出す条件: 参照の控え（referenceHints）がある、プリセットの表示名がある、または候補がある。
• 参照の控え: 参照ごとのキー（配列の添字をプリセット id / シーン sceneUid に置き換えたパス）と、対象 GameObject のシーンルートからの名前の並び（path）・同名兄弟内の順番（order）。タイムライン生成時と割り当て時に更新する。外れている参照の控えは保持し、Config から無くなった参照の控えは削除する。
• 一覧は種類ごとに分ける: 設定 / {種別}のプリセット / シーン（自由指定）。列は 名前 / 割り当て / 候補。削除されたオブジェクトを参照していた行は ⚠ を付ける。
• 「候補をスキャン」: 読み込み済みの全シーンから候補を探す。

• 種類で絞る条件: カメラのプリセットは CinemachineVirtualCamera、ポストプロセスのプリセットは PostProcessVolume を持つもの、照明は子孫に Light または MeshRenderer を持つもの。
• 「候補をまとめて割り当てる（N 件）」、行ごとの「割り当てる」・「✕」（候補を取り下げる）、割り当て欄への直接指定で割り当てる。割り当てた行は一覧から外す。

ワープ地点と Gizmo

• ワープの行の「新規作成」: 生成物の親の子 _WarpPoints/Char_{キャラクター名}/ に GameObject {シーン名}（空なら warppoint。Hierarchy に使えない / \ : * ? " < > | は _ に置換。同名がある場合は _2、_3 … を付加）を Scene ビューの注視点に作成し、destinationTransform に設定する。キャラクター名が空の場合は character_{番号}。
• ウィンドウ表示中（閲覧モード OFF）、いずれかのワープの destinationTransform になっている Transform に MashiroWarpPointGizmo を追加し、Config と同じシーン内でどのワープにも使われていない MashiroWarpPointGizmo を削除する。
• Scene ビューに位置（半径 0.07 の円）と Y 回転方向（長さ 0.18 の矢印）を描画する。

Config

StageTimelineConfig

Inspector に表示しないフィールド:

• Reset()（Add Component 時）で InitializeAsNewBuilderData() を呼ぶ。

ShowScene

SceneDivider

プリセット

全プリセット共通（CharacterEntry を除く）: id（string、自動採番）、displayName（string、UI「表示名」）。

演出エントリ

bindingMode（Direct / Preset）と presetId（string）を持つエントリ: ToggleEntry / ObjectAnimationEntry / LightFadeEntry / BgmEntry / SeEntry / AnimatorParameterEntry / AnimatorTriggerEntry / UdonEventEntry。Direct 用の対象フィールドは Preset 指定時、プリセットが見つからない場合のみ使う。

MashiroWarpPointGizmo

Inspector フィールドは無い。[DisallowMultipleComponent]、AddComponentMenu: Mashiro Theater/Mashiro Warp Point Gizmo。

API リファレンス

UI へ手配線するものは無い。以下はすべてエディタまたは他コンポーネントから呼ばれる内部連携用（配線不要）。

StageTimelineBuilderWindow

StageTimelineQSheetWindow

StageTimelineGenerator

TimelineBuildResult: SceneCount / ObjectTrackCount / LightRootCount / BgmTrackCount / BlackoutSceneCount（int）、Warnings（List<string>）、void LogSummary(string title)（集計を Console に出力）。

StageTimelineConfig

エントリ・プリセットクラス

その他

• TimelineWriters / StagePlanning / AssetUtils の public static メンバーは Generator・ビルダーの内部処理用。
• StageTimelineConfigBackupWriter / StageTimelineDirectorResolver / StageTimelineDividers / StageTimelineQSheetExporter / StageTimelineQSheetModel / StageTimelineReferenceHints / StageTimelineReferenceValidator / StageTimelineSceneListView / BuilderStyles / EffectCategory は internal。

ライセンス

MIT License ではない。LICENSE.md（ましろ小劇場 ツール・ギミック汎用利用規約）に基づいて提供する。規約の正本は VN3License_ja.pdf（VN3 ライセンス様式）。

本ドキュメントは AI を用いて作成しています。不明点・記載の誤りなどありましたら、下記までお問い合わせください。

• メール: contact@mashirotheater.com
• X: https://x.com/hakushiza
• Discord: https://discord.com/invite/yU2Es38sVX