AgentSkillsCN

uloop-get-hierarchy

获取Unity层级结构。适用于场景结构的检查、GameObject的探索、父子关系的确认，或当用户询问层级结构时使用。返回包含组件的场景GameObject树。

SKILL.md
--- frontmatter
name: uloop-get-hierarchy
description: "Get Unity Hierarchy structure. Use when: inspecting scene structure, exploring GameObjects, checking parent-child relationships, or when user asks about hierarchy. Returns the scene's GameObject tree with components."

uloop get-hierarchy

Get Unity Hierarchy structure.

Usage

bash
uloop get-hierarchy [options]

Parameters

ParameterTypeDefaultDescription
--root-pathstring-Root GameObject path to start from
--max-depthinteger-1Maximum depth (-1 for unlimited)
--include-componentsbooleantrueInclude component information
--include-inactivebooleantrueInclude inactive GameObjects
--include-pathsbooleanfalseInclude full path information
--use-selectionbooleanfalseUse selected GameObject(s) as root(s). When true, --root-path is ignored.

Examples

bash
# Get entire hierarchy
uloop get-hierarchy

# Get hierarchy from specific root
uloop get-hierarchy --root-path "Canvas/UI"

# Limit depth
uloop get-hierarchy --max-depth 2

# Without components
uloop get-hierarchy --include-components false

# Get hierarchy from currently selected GameObjects
uloop get-hierarchy --use-selection

Output

Returns JSON with hierarchical structure of GameObjects and their components.