uloop-find-game-objects

uloop 查找游戏对象

根据搜索条件查找 GameObject，或获取当前在 Hierarchy 中选中的对象的详细信息。

在识别或检查选中的 GameObject 时，请先使用此工具，再使用 execute-dynamic-code。如果需要子级树、父子结构或选中对象下的后代对象，请改用 get-hierarchy。

用法

uloop find-game-objects [options]

参数

参数	类型	默认值	描述
--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	-	在结果中包含继承的属性

搜索模式

模式	描述
exact	精确匹配名称（默认）。注意：--name-pattern "Camera" 不会匹配名为 "Main Camera" 的 GameObject——部分匹配请使用 contains 或 regex。exact 搜索无匹配结果时，会返回一条 Message 提示说明这一点。
path	搜索 Hierarchy 路径（例如，Canvas/Button）
regex	正则表达式模式
contains	部分名称匹配
selected	获取 Unity Editor 中当前选中的 GameObject

输出

返回包含以下内容的 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）和 Properties（数组，包含 Inspector 中可见的 {Name, Type, Value} 属性对）
• TotalFound（number）：返回的结果数（经 --max-count 截断后）。对于多选文件导出，此值为导出的对象数。
• ErrorMessage（string）：顶层失败摘要（成功时为空）
• ProcessingErrors（数组）：selected 模式下，按 GameObject 列出的序列化失败信息，每项包含 {GameObjectName, GameObjectPath, Error}。正常运行时省略、为 null 或为空。

多选文件导出

在 selected 模式下，如果有多个 GameObject 成功序列化，则不会填充内联的 Results，而是将数据写入文件。此时会额外出现两个字段：

• ResultsFilePath（string）：.uloop/outputs/FindGameObjectsResults/ 下的相对路径
• Message（string）：人类可读的摘要（例如，“已导出 5 个 GameObject”）

单选和搜索模式调用（exact、path、regex、contains）始终以内联方式返回结果。未选中任何对象时（selected 模式且选区为空），会返回空的 Results 和一条 Message。