uloop-find-game-objects

uloop find-game-objects

検索条件に一致する GameObject を検索するか、現在選択されている Hierarchy オブジェクトの詳細を取得します。

選択した GameObject を特定または調査する場合は、execute-dynamic-code の前に使用してください。子ツリー、親子構造、または選択範囲内の子孫が必要な場合は、代わりに get-hierarchy を使用してください。

Usage

uloop find-game-objects [options]

Parameters

パラメーター	型	デフォルト	説明
--name-pattern	string	-	検索する名前のパターン
--search-mode	string	exact	検索モード：exact、path、regex、contains、selected
--required-components	array	-	必須コンポーネント
--tag	string	-	タグフィルター
--layer	integer	-	レイヤーフィルター（レイヤー番号）
--max-count	integer	20	結果の最大数
--include-inactive	flag	-	非アクティブな GameObject を含めます
--include-inherited-properties	flag	-	結果に継承されたプロパティを含めます

Search Modes

モード	説明
exact	名前が完全に一致するものを検索します（デフォルト）。注意：--name-pattern "Camera" は "Main Camera" という名前の GameObject には一致しません。部分一致には contains または regex を使用してください。一致がゼロ件の exact 検索では、この点を示すヒントが Message に返されます。
path	Hierarchy のパスで検索します（例：Canvas/Button）
regex	正規表現パターン
contains	名前の部分一致
selected	Unity Editor で現在選択されている GameObject を取得します

Output

次の内容を含む JSON を返します。

• Results（配列）：一致した GameObject。各項目には以下が含まれます。
  • Name（string）：GameObject の名前
  • Path（string）：Hierarchy のパス（例：Canvas/Panel/Button）
  • IsActive（boolean）：Hierarchy 内でのアクティブ状態
  • Tag（string）：GameObject のタグ
  • Layer（number）：レイヤーインデックス
  • Components（配列）：各項目には、Type（短い名前。例：Rigidbody）、FullTypeName（例：UnityEngine.Rigidbody）、および Inspector に表示される {Name, Type, Value} のペアの配列である Properties が含まれます
• TotalFound（number）：返された結果の数（--max-count による制限後）。複数選択時のファイル出力では、出力された数です。
• ErrorMessage（string）：最上位の失敗概要（成功時は空）
• ProcessingErrors（配列）：選択モードで GameObject のシリアライズに失敗した場合の項目。各項目は {GameObjectName, GameObjectPath, Error} です。問題なく処理された場合は、省略または null、あるいは空になります。

複数選択時のファイル出力

selected モードでシリアライズに成功した GameObject が複数ある場合、インラインの Results は設定されず、データはファイルに書き込まれます。次の 2 つのフィールドが追加されます。

• ResultsFilePath（string）：.uloop/outputs/FindGameObjectsResults/ 配下の相対パス
• Message（string）：人間が読める概要（例："5 GameObjects exported"）

単一選択および検索モード（exact、path、regex、contains）の呼び出しでは、常にインラインで結果が返されます。選択なしの場合（選択が空の selected モード）は、空の Results と Message が返されます。