메뉴
Controls the UnravelEngine Scene panel editor camera and viewport screenshots via MCP. Use when framing entities, looking at points, orbiting, resetting the viewport camera, or capturing Scene/Game screenshots.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Manages UnravelEngine asset pipeline: importers, .meta sidecars, UID stability, asset compilation, async loading, and reimport. Use for asset types, import errors, content browser issues, or compiled .asset output.
Builds and verifies UnravelEngine: CMake targets, engine_data/editor_data copy, .NET SDK / CoreCLR scripting dependency, sanitizers, and CI workflows. Use after code changes, before marking work complete, or when fixing build/CI failures.
Creates and edits UnravelEngine scene entities via Editor MCP: hierarchy, coordinate system (X-right Y-up Z-forward), WORLD vs LOCAL transforms, components, ScriptComponent source, and scene_save. Use when spawning primitives, parenting, placing children, attaching C# scripts, or persisting .spfb scenes.
Creates and edits UnravelEngine PBR materials via Editor MCP tools or code. Use when changing .mat assets, model material slots, runtime material instances, or deciding asset vs instance edit paths.
Opens/closes UnravelEngine editor projects, lists recent projects, and opens or creates scenes from defaults::scene_preset via Editor MCP. Use when switching projects, loading .spfb scenes, or bootstrapping a new preset scene.
Works on UnravelEngine managed scripting: C# API, script glue, hot-reload, ScriptComponent lifecycle, and C++/C# interop via dotnetpp (CoreCLR). Use for game scripts, scripting backend, OnCreate/OnUpdate hooks, or physics/UI events forwarded to C#.
| name | unravel-viewport |
| description | Controls the UnravelEngine Scene panel editor camera and viewport screenshots via MCP. Use when framing entities, looking at points, orbiting, resetting the viewport camera, or capturing Scene/Game screenshots. |
| disable-model-invocation | true |
The Scene panel camera lives in a private panel scene (scene_panel), not the edit scene. Resolve it via hub → get_scene_panel().get_camera().
World axes match entities: X-right, Y-up, Z-forward. Camera position / look_at target are world-space.
| Tool | Purpose |
|---|---|
viewport_get_camera | Read pose / FOV / ortho |
viewport_set_camera | Set position / rotation_euler; relative:true = local offset |
viewport_look_at | Aim at world target (optional position, up) |
viewport_focus_entities_batch | defaults::focus_camera_on_entities (same as F / double-click) |
viewport_focus_bounds | Focus sphere (center+radius) or box (min+max) |
viewport_orbit_camera | Orbit around pivot by yaw/pitch degrees |
viewport_reset_camera | UI “Reset Camera” parity |
viewport_screenshot_scene / _game | PNG capture |
panel_focus_scene | Focus Scene panel tab (editing camera) |
panel_focus_game | Focus Game panel tab (game camera) |
Prefer panel_focus_game before play-mode verification / game screenshots when the Game tab may be buried. Prefer panel_focus_scene before scene camera / selection workflows.
defaults::focus_* keeps current rotation and dollies along forward to fit bounds.aim:true to look_at the bounds center before focusing (frame + face).duration default 0.4 (UI); use 0 for instant (better before screenshots)."camera_focus"; set/look/orbit/reset cancel it first.// Frame an entity and aim at it, instant
{"entity_id":"<uuid>","aim":true,"duration":0}
// Move then look
{"position":[0,2,-8],"target":[0,1,0]}
// Orbit 45° around a pivot
{"pivot":[0,1,0],"yaw":45,"pitch":-10}
| Purpose | Path |
|---|---|
| Focus APIs | engine/engine/defaults/defaults.h |
| Scene panel camera | editor/editor/hub/panels/scene_panel/scene_panel.* |
| MCP tools | editor/editor/system/mcp/mcp_tools_viewport.cpp |
| Panel focus MCP | editor/editor/system/mcp/mcp_tools_editor.cpp (panel_focus_*) |
| Panel focus API | editor_actions::focus_scene_panel / focus_game_panel → panel_base::focus() |