メニュー
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() |