noah-zll 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_renamedo not exist → delete scene files viaasset_delete, rename viaasset_movescene_listdoes not exist → usescene_get_loaded(loaded scenes) orasset_findwitht:Scene(all scene assets)scene_find_objectsis a simple name/tag/component filter; for regex/layer/path search usegameobject_find(Full-Auto)
Routing:
- For detailed hierarchy tree → use
perceptionmodule'shierarchy_describe - For scene statistics → use
perceptionmodule'sscene_summarize - For screenshot →
scene_screenshot(this module) orcamera_screenshot(camera module, Full-Auto)
Skills Overview
| Skill | Description |
|---|---|
scene_create |
Create a new scene |
scene_load |
Load a scene |
scene_save |
Save current scene |
scene_get_info |
Get scene information |
scene_get_hierarchy |
Get hierarchy tree |
scene_screenshot |
Capture screenshot |
scene_get_loaded |
Get all loaded scenes |
scene_unload |
Unload an additive scene |
scene_set_active |
Set active scene |
scene_find_objects |
Search objects by name/tag/component |
Skills
scene_create
Create a new scene.
| Parameter | Type | Required | Description |
|---|---|---|---|
scenePath |
string | Yes | Path for new scene (e.g., "Assets/Scenes/MyScene.unity") |
scene_load
Load a scene.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
scenePath |
string | Yes | - | Scene asset path |
additive |
bool | No | false | Load additively (keep current scene) |
scene_save
Save the current scene.
| Parameter | Type | Required | Description |
|---|---|---|---|
scenePath |
string | No | Save path (null = save current) |
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.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
maxDepth |
int | No | 10 | Maximum hierarchy depth |
Returns: {success, hierarchy: [{name, instanceId, children: [...]}]}
scene_screenshot
Capture a screenshot.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filename |
string | No | "screenshot.png" | Output filename |
width |
int | No | 1920 | Image width |
height |
int | No | 1080 | Image height |
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).
| Parameter | Type | Required | Description |
|---|---|---|---|
sceneName |
string | Yes | Scene name to unload |
scene_set_active
Set the active scene (for multi-scene editing).
| Parameter | Type | Required | Description |
|---|---|---|---|
sceneName |
string | Yes | Scene name to set active |
scene_find_objects
Search GameObjects by name pattern, tag, or component type. For advanced search (regex, layer, path) use gameobject_find.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
namePattern |
string | No | - | Name substring to match (case-insensitive) |
tag |
string | No | - | Filter by tag |
componentType |
string | No | - | Filter by component type name |
limit |
int | No | 50 | Max results to return |
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
- Always save before loading a new scene
- Use additive loading for UI overlays
- Keep scene hierarchy organized with empty parent objects
- Use
scene_get_infoto verify scene state - Screenshots are saved to project root by default