CommandGraph：ノードベースのイベントスクリプティング
CommandGraph は MCE のビジュアルスクリプティングシステムで、NPC の動作、カットシーン、クエスト、インタラクティブイベントを作成するためのものです。コマンドを接続してイベントシーケンスを定義するノードベースのエディタを提供します -- C# コードは不要です。
これは DLL ティアを含む、ソースコードにアクセスできないすべてのティアのゲームデザイナーにとって主要なツールです。
CommandGraph とは？
CommandGraph は Actor（ワールド内の任意のインタラクト可能なエンティティ）に紐付けられたノードグラフで す。プレイヤーがアクター（インタラクト、踏む、またはエリアに進入）をトリガーすると、グラフがノードを順次実行します。
ビジュアルスクリプトとして考えてください。各ノードがゲームアクションです：
[Start] → [Show Dialog] → [Branch: Has Badge?]
├─ Yes → [Give Item] → [End]
└─ No → [Show Dialog: "Come back later"] → [End]
最初のイベントの作成
ステップ 1：アクターの作成
- シーン内のNPCを配置したい場所に空の GameObject を作成。
Actorコンポーネント（またはそのバリアント：SimpleActor、TriggerActor）を追加。- NPC のビジュアル用に
SpriteRendererを追加。 - アクターは自動的に
GridControllerに登録されます。
ステップ 2：CommandGraph エディタを開く
- Actor の GameObject を選択。
- Inspector で CommandGraph セクションを見つけます。
- Edit Graph をクリックしてノードエディタウィンドウを開きます。
ステップ 3：ノードの追加
- グラフエディタ内で右クリックして Add Node メニューを開きます。
- ノードはカテゴリ別に整理されています（下記参照）。
- ノードタイプを選択してグラフに追加。
- ノードの出力ポートから別のノードの入力ポートにドラッグして接続。
ステップ 4：ノードの設定
ノードをクリックすると Inspector パネルにプロパティが表示されます：
- ダイアログノード：表示するテキスト、話者名、ポートレートを入力。
- 分岐ノード：チェックするゲーム変数と比較方法を選択。
- アイテムノード：付与/除去するアイテムと数量を選択。
- ワープノード：ターゲットシーンと位置を設定。
アクタータイプ
MCE は複数のアクターバリアントを提供します：
| アクタータイプ | トリガー | 用途 |
|---|---|---|
Actor | プレイヤーがインタラクト（向かい合ってアクションボタンを押す） | NPC、看板、オブジェクト |
SimpleActor | プレイヤーがインタラクト、簡略化セットアップ | 基本的なNPC |
TriggerActor | プレイヤーが踏むまたはエリアに進入 | 自動トリガー、隠しイベント |
GridSubscribingActor | グリッドイベントに反応 | 感圧板、近接 |
PushableActor | プレイヤーが歩いて押す | 岩、パズルブロック |
ActorItem | プレイヤーがインタラクト、アイテムを付与して消滅 | 地面のアイテム拾い |
ノードカテゴリ
ダイアログ
テキストの表示、応答の選択、会話の管理。
| ノード | 説明 |
|---|---|
| ShowDialog | 話者のメッセージを含むテキストボックスを表示 |
| ShowChoiceDialog | プレイヤーに複数選択肢を提示 |
| ShowMonsterDialog | モンスターに関連するダイアログを表示（スプライト付き） |
| CharacterPopUp | NPC の頭上にポップアップを表示（!、?、...） |
ShowDialog の例：
Speaker: "Professor Elm"
Text: "Welcome to the world of monsters!"
Portrait: oak_portrait
Wait for Input: true
分岐
条件に基づいてフローを制御。
| ノード | 説明 |
|---|---|
| BranchOnVariable | GameVariable をチェックして Yes/No に分岐 |
| BranchOnBadge | プレイヤーが特定のバッジを持っているかチェック |
| BranchOnItem | プレイヤーが特定のアイテムを持っているかチェック |
| BranchOnMonster | プレイヤーのパーティに特定の種族がいるかチェック |
| BranchOnMoney | プレイヤーが十分なお金を持っているかチェック |
| BranchOnRosterCount | パーティのモンスター数をチェック |
各分岐ノードには True と False の2つの出力ポートがあります。
アイテム
プレイヤーのインベントリを管理。
| ノード | 説明 |
|---|---|
| GiveItem | プレイヤーのバッグにアイテムを追加 |
| TakeItem | プレイヤーのバッグからアイテムを削除 |
| GiveMonster | プレイヤーのパーティにモンスターを追加 |
| GiveMoney | プレイヤーの財布にお金を追加 |
| TakeMoney | プレイヤーの財布からお金を削除 |
モンスター
プレイヤーのモンスターとのインタラクション。
| ノード | 説明 |
|---|---|
| HealParty | パーティの全モンスターを完全回復 |
| SelectMonster | プレイヤーがモンスターを選ぶためのパーティ画面を開く |
| TeachMove | モンスターに特定の技を教える |
| EvolutionCheck | パーティ全員の進化チェックをトリガー |
| SetNickname | プレイヤーがモンスターの名前を変更できるようにする |
バトル
バトルのトリガーと設定。
| ノード | 説明 |
|---|---|
| StartTrainerBattle | 設定済みのチームとトレーナーバトルを開始 |
| StartWildBattle | 特定のモンスターと野生エンカウントを開始 |
| BranchOnBattleResult | プレイヤーが前回のバトルに勝利したかチェック |
変数
ゲーム状態の読み書き。
| ノード | 説明 |
|---|---|
| SetVariable | GameVariable に値を設定 |
| AddToVariable | 数値の GameVariable に加算 |
| CheckVariable | GameVariable の値をロジック用に読み取り |
GameVariable はグローバル状態システムです。セーブデータに永続化され、任意の CommandGraph やスクリプトからチェックできます。
サウンド
オーディオ再生の制御。
| ノード | 説明 |
|---|---|
| PlayBGM | BGMを変更 |
| PlaySE | 効果音を再生 |
| StopBGM | 現在の音楽を停止 |
| FadeOutBGM | 指定時間で音楽をフェードアウト |
アニメーション
キャラクターとカメラのアニメーション。
| ノード | 説明 |
|---|---|
| MoveActor | NPCを目標位置に移動 |
| TurnActor | NPCを特定の方向に向ける |
| WaitSeconds | グラフを指定時間一時停止 |
| FadeScreen | 画面を黒くフェードまたは戻す |
| ShakeScreen | カメラを揺らす |
ワープ
プレイヤーを場所間で移動。
| ノード | 説明 |
|---|---|
| TeleportPlayer | プレイヤーを現在のシーン内の特定タイルに移動 |
| WarpToScene | プレイヤーを別のシーンに遷移 |
クエスト（Pro ティア以上）
クエストの進行管理。
| ノード | 説明 |
|---|---|
| StartQuest | クエストを開始 |
| CompleteObjective | クエスト目標を完了としてマーク |
| FailQuest | クエストを失敗にする |
| BranchOnQuestState | クエストの現在の状態をチェック |
| GiveQuestReward | クエストの報酬を付与 |
ショップ
ショップインターフェースを開く。
| ノード | 説明 |
|---|---|
| OpenShop | 設定済みアイテムリストで売買ショップUIを開く |
セーブ
セーブデータの管理。
| ノード | 説明 |
|---|---|
| SaveGame | 現在のスロットへのセーブをトリガー |
ユーティリティ
その他のユーティリティノード。
| ノード | 説明 |
|---|---|
| DeactivateActor | アクターを非表示にする（アイテム拾い後など） |
| EnablePlayer | プレイヤーの移動を有効/無効にする |
ノードの接続
CommandGraph はフローベースの接続モデルを使用します：
- 各ノードには入力ポート（左側）と1つ以上の出力ポート（右側）があります。
- 出力ポートを別のノードの入力ポートに接続して実行順序を定義します。
- 分岐ノードにはラベル付きの出力ポートがあります（True/False、Choice1/Choice2 など）。
- 接続されていない出力ポートを持つノードはグラフの実行を終了します。
例：ショップNPC
[Start]
→ [ShowDialog: "いらっしゃいませ！何かお探しですか？"]
→ [ShowChoiceDialog: "買う" / "売る" / "いいえ"]
├─ Choice 1 ("買う") → [OpenShop: item_list_potions]
├─ Choice 2 ("売る") → [OpenShop: sell_mode]
└─ Choice 3 ("いいえ") → [ShowDialog: "またのお越しをお待ちしております！"]
例：クエスト依頼者
[Start]
→ [BranchOnVariable: "rescued_lost_monster" == true]
├─ True → [ShowDialog: "モンスターを見つけてくれてありがとう！"]
│ → [BranchOnVariable: "quest_reward_given" == true]
│ ├─ True → [ShowDialog: "わざマシンを使ってね！"]
│ └─ False → [GiveItem: TM_Thunderbolt, 1]
│ → [SetVariable: "quest_reward_given" = true]
│ → [ShowDialog: "お礼にこれを受け取ってください！"]
└─ False → [ShowDialog: "迷子のモンスターを探してほしいのです！"]
→ [ShowDialog: "北の洞窟に逃げ込んだようです。"]
→ [SetVariable: "quest_find_monster" = true]
例：ジムリーダー
[Start]
→ [BranchOnBadge: "BoulderBadge"]
├─ HasBadge → [ShowDialog: "もうすでに実力を証明しましたね！"]
└─ NoBadge
→ [ShowDialog: "私がジムリーダーだ！バトルの準備をしろ！"]
→ [StartTrainerBattle: gym_leader_team]
→ [BranchOnBattleResult]
├─ Won → [ShowDialog: "見事だ！これを受け取れ。"]
│ → [GiveBadge: "BoulderBadge"]
│ → [GiveItem: TM_RockTomb, 1]
└─ Lost → [ShowDialog: "もっと鍛えて出直してこい！"]
イベントのテスト
- エディタでプレイモードに入ります。
- キャラクターをアクターまで歩かせます。
- インタラクトボタン（デフォルト：Z またはゲームパッドの A）を押します。
- CommandGraph が実行され、フローを観察できます。
デバッグモード
グラフが期待通りに動作しない場合：
- Console でエラーを確認してください。
- 参照されている GameVariable、アイテム、モンスターが存在するか確認してください。
- すべての出力ポートが接続されていることを確認してください -- 未接続の分岐は静かにグラフ を終了します。
Debugノード（利用可能な場合）を使用して実行中の変数状態をログ出力してください。
ベストプラクティス
- アクターにはわかりやすい名前を付けましょう。「NPC_Professor_Lab」は「Actor (3)」より良いです。
- 状態には GameVariable を使用しましょう。アクターの有効/無効だけに頼らないでください。
- 両方の分岐をテストしましょう。すべての BranchOnVariable で True と False の両方のパスが動作することを確認してください。
- グラフを読みやすく保ちましょう。空間レイアウトを使ってフローを明確にしてください。関連するノードをまとめましょう。
- パターンを再利用しましょう。動作するショップNPCができたら、複製して他のショップ用に修正してください。
- テスト前にセーブしましょう。CommandGraph の変更はシーンレベルの変更であり、Unity がクラッシュすると失われる可能性があります。