AgentSkillsCN

uloop-find-game-objects

通过 uloop CLI 使用搜索条件查找 GameObject。适用于以下情况:(1) 按名称模式定位 GameObject,(2) 按标签或层级查找对象,(3) 搜索具有特定组件类型的对象。

SKILL.md
--- frontmatter
name: uloop-find-game-objects
description: Find GameObjects with search criteria via uloop CLI. Use when you need to: (1) Locate GameObjects by name pattern, (2) Find objects by tag or layer, (3) Search for objects with specific component types.

uloop find-game-objects

Find GameObjects with search criteria.

Usage

bash
uloop find-game-objects [options]

Parameters

ParameterTypeDefaultDescription
--name-patternstring-Name pattern to search
--search-modestringContainsSearch mode: Exact, Path, Regex, Contains
--required-componentsarray-Required components
--tagstring-Tag filter
--layerstring-Layer filter
--max-resultsinteger20Maximum number of results
--include-inactivebooleanfalseInclude inactive GameObjects

Examples

bash
# Find by name
uloop find-game-objects --name-pattern "Player"

# Find with component
uloop find-game-objects --required-components Rigidbody

# Find by tag
uloop find-game-objects --tag "Enemy"

# Regex search
uloop find-game-objects --name-pattern "UI_.*" --search-mode Regex

Output

Returns JSON array of matching GameObjects with paths and components.