uloop-get-hierarchy

Original🇺🇸 English
Translated

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.

3installs
Added on

NPX Install

npx skill4agent add hatayama/uloopmcp uloop-get-hierarchy

uloop get-hierarchy

Get Unity Hierarchy structure.

Usage

bash
uloop get-hierarchy [options]

Parameters

ParameterTypeDefaultDescription
--root-path
string-Root GameObject path to start from
--max-depth
integer
-1
Maximum depth (-1 for unlimited)
--include-components
boolean
true
Include component information
--include-inactive
boolean
true
Include inactive GameObjects
--include-paths
boolean
false
Include full path information
--use-selection
boolean
false
Use selected GameObject(s) as root(s). When true,
--root-path
is ignored.

Global Options

OptionDescription
--project-path <path>
Target a specific Unity project (mutually exclusive with
--port
). Path resolution follows the same rules as
cd
— absolute paths are used as-is, relative paths are resolved from cwd.
-p, --port <port>
Specify Unity TCP port directly (mutually exclusive with
--project-path
).

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.