unity-scene（Unity scene 搜索）

Unity Scene Skills

Control Unity scenes - the containers that hold all your GameObjects.

Guardrails

Mode: Semi-Auto (available by default)

DO NOT (common hallucinations):

• scene_delete / scene_rename do not exist → delete scene files via asset_delete, rename via asset_move
• scene_list does not exist → use scene_get_loaded (loaded scenes) or asset_find with t:Scene (all scene assets)
• scene_find_objects is a simple name/tag/component filter; for regex/layer/path search use gameobject_find (Full-Auto)

Routing:

• For detailed hierarchy tree → use perception module's hierarchy_describe
• For scene statistics → use perception module's scene_summarize
• For screenshot → scene_screenshot (this module) or camera_screenshot (camera module, Full-Auto)

Skills Overview

Skills

scene_create

Create a new scene.

scene_load

Load a scene.

scene_save

Save the current scene.

scene_get_info

Get current scene information.

No parameters.

Returns: {success, name, path, isDirty, rootObjectCount, rootObjects: [name]}

scene_get_hierarchy

Get full scene hierarchy tree.

Returns: {success, hierarchy: [{name, instanceId, children: [...]}]}

scene_screenshot

Capture a screenshot.

scene_get_loaded

Get list of all currently loaded scenes.

No parameters.

Returns: {success, scenes: [{name, path, isActive, isDirty}]}

scene_unload

Unload a loaded scene (additive).

scene_set_active

Set the active scene (for multi-scene editing).

scene_find_objects

Search GameObjects by name pattern, tag, or component type. For advanced search (regex, layer, path) use gameobject_find.

Returns: {success, count, objects: [{name, path, instanceId, active, tag}]}

Example Usage

import unity_skills

# Create a new scene
unity_skills.call_skill("scene_create", scenePath="Assets/Scenes/Level1.unity")

# Load an existing scene
unity_skills.call_skill("scene_load", scenePath="Assets/Scenes/MainMenu.unity")

# Load scene additively (multi-scene)
unity_skills.call_skill("scene_load", scenePath="Assets/Scenes/UI.unity", additive=True)

# Get current scene info
info = unity_skills.call_skill("scene_get_info")
print(f"Scene: {info['name']}, Objects: {info['rootObjectCount']}")

# Get full hierarchy (useful for understanding scene structure)
hierarchy = unity_skills.call_skill("scene_get_hierarchy", maxDepth=5)

# Save scene
unity_skills.call_skill("scene_save")

# Take screenshot
unity_skills.call_skill("scene_screenshot", filename="preview.png", width=1920, height=1080)

Best Practices

1. Always save before loading a new scene
2. Use additive loading for UI overlays
3. Keep scene hierarchy organized with empty parent objects
4. Use scene_get_info to verify scene state
5. Screenshots are saved to project root by default

Exact Signatures

Exact names, parameters, defaults, and returns are defined by GET /skills/schema or unity_skills.get_skill_schema(), not by this file.