用途:在 Unity 环境中查找 GameObject,或获取当前在 Hierarchy 中被选中对象的详情。官方建议在 execute-dynamic-code 前用它识别或检查选中的 GameObject;若需要子节点树、父子结构或选中项下的后代,应改用 get-hierarchy。
用法:uloop find-game-objects [options]。参数包括:--name-pattern(名称模式)、--search-mode(exact、path、regex、contains、selected,默认 exact)、--required-components(必需组件)、--tag(标签过滤)、--layer(层级号过滤)、--max-count(默认20)、--include-inactive(包含未激活对象)、--include-inherited-properties(包含继承属性)。
模式说明:exact 为精确名称匹配,注意 --name-pattern "Camera" 不会匹配名为 "Main Camera" 的对象,零结果时会有 Message 提示,部分匹配需用 contains 或 regex;path 按层级路径搜索(如 Canvas/Button);regex 为正则;contains 为部分匹配;selected 获取当前在 Unity 编辑器中选中的 GameObject。
输出:返回 JSON,含 Results 数组(每项有 Name、Path、IsActive、Tag、Layer、Components,其中 Components 含 Type、FullTypeName、Properties)、TotalFound、ErrorMessage,以及 selected 模式下的 ProcessingErrors。selected 模式选中多个可成功序列化的对象时,Results 不内联,而写入 .uloop/outputs/FindGameObjectsResults/,并返回 ResultsFilePath 和 Message。单选和搜索模式始终内联返回;selected 模式无选中时返回空 Results 加 Message。