Mass Debugger の概要

概要

Mass Debugger ツールは、エンティティ フラグメント データのリアルタイム検査、エンティティ固有のフラグメント アクセス ブレークポイント、ゲームプレイ デバッガの統合、プロセッサ検査の改善など、多くの新機能によって大幅に改善されました。

Mass Debugger を使用する

Mass Debugger を起動するには、エディタから [Tools (ツール)] > [Debug (デバッグ)] > [Mass Debugger] の順に選択します。 注：以前のバージョンの Mass Debugger を起動したことがある場合は、レイアウトをリセットしないと新しいタブが表示されないことがあります ([Mass Debugger] ウィンドウで [Window (ウィンドウ)] > [Reset Layout (レイアウトをリセット)] を選択します)。

UI ワークフロー

プロセッサのデータ アクセス オーバーラップを確認するには、次の手順に従います。

1. Mass Debugger を開きます。

2. 環境ピッカーを使用して、検査する Mass ランタイム環境を選択します。

3. [Processors (プロセッサ)] タブを開きます ([Window] > [Processors])。

4. リストで検査するプロセッサを見つけます。

5. プロセッサのエントリにある [Show Fragment Access (フラグメント アクセスを表示)] ボタンをクリックします。

6. 展開したプロセッサのエントリにある [Queries (クエリ)] リストのフラグメントをクリックします。

Mass Debugger を使用して、アクティブな環境を選択した状態でエンティティのフラグメント データを検査するには、次の手順に従います。

1. [Entities (エンティティ)] タブを開きます ([Window] > [Entities]、またはデバッガ UI のコンテキスト メニューにある [Show Entities (エンティティを表示)] ボタンを使用します)。

2. [Select Fragments (フラグメントを選択)] ドロップダウンをクリックして、検査するフラグメントを確認します。

   1. 注：フラグメントのリストは、リストされたエンティティの構成によって異なります。

   2. 注：UPROPERTY としてマークされている選択したフラグメント構造体のメンバー変数のみが表示されます。 その他のエディタ可視性メタデータは必要ありません。

特定のエンティティについて、特定のフラグメントの書き込みブレークポイントを設定するには、次の手順に従います。

1. 目的のエンティティのフラグメントデータを [Entities] タブに表示します。

2. [Set Write Breakpoint (書き込みブレークポイントを設定)] ボタンをクリックします。

3. 注：ブレークポイントは MassExecutionContext::EntitiyIterator の EntityIterator コードでトリガーされます。 このイテレータ、またはそのイテレータのラッパーを使用するコードのみが、この方法でブレークポイントをトリガーできます。 通常、トリガーするコードはコールスタックの 2 つまたは 3 つ上のレベルにあります。

4. IDE からブレークポイントをクリアして実行を再開するには、IDE のウォッチ機能を使用して、bDisableThisBreakpoint 変数を「true」か「1」に設定します。

選択したエンティティに対して、指定したフラグメントの書き込みブレークポイントを設定するには、次の手順に従います。

1. [Fragments (フラグメント)] タブを開きます。

2. 目的のフラグメントを見つけます。

3. 選択したエンティティの書き込みを中断するボタンをクリックします。

4. [Entities] タブかゲームプレイ デバッガ ツール (コンソール コマンド「EnableGDT」) を使用してエンティティを選択します。

制限事項

• ブレークポイント機能は Visual Studio 2022 でのみテストされており、他の IDE ではサポートされない可能性があります

• ブレークポイントは、エンティティのイテレーションに MassExecutionContext::CreateEntityIterator を使用するコードに対してのみ機能します

• フラグメントの検査には UPROPERTY RTTI が必要なため、UPROPERTY でマークされたメンバー変数のみが表示されます