菜单
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.
用 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.
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#.
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.
| name | unravel-materials |
| description | 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. |
| disable-model-invocation | true |
| Path | When | Persist |
|---|---|---|
Material asset (.mat) | Shared look used by many meshes; Content Browser / inspector material | Disk via atomic_save_to_file |
| Model material slot | Assign which asset a model_component uses | Scene/prefab only |
| Material instance | One entity’s override (prototype/tweak) | Scene/prefab only — never writes .mat |
Create parity: content browser get_asset_from_instance<material>(key, pbr_material) + save.
Save parity: inspector inspector_asset_handle_material on edit_finished.
| Tool | Purpose |
|---|---|
materials_create_batch | New .mat files (items: path or folder+name) |
materials_get_batch | Read props for many (items: key / uid) |
materials_set | Mutate asset; save default true; optional wait_ms |
materials_list_properties | Supported property schema |
scene_set_model_materials_batch | Shared slot assignments (one undo) |
scene_set_model_material_instances_batch | Runtime instance props; no .mat |
scene_clear_model_material_instances_batch | Drop instances → use assets again |
assets_find_batch | Find materials (and all other asset types) by type/prefix/name_contains |
window_request_focus | Focus/raise editor OS window so asset watcher can import new .mat files |
When the editor is unfocused, filesystem watcher events may not run — call window_request_focus before materials_create_batch / assets_wait_ready_batch if creates do not land.
Single-property edits: one-key properties object. Bulk: multiple keys in one call.
{
"key": "app:/data/Materials/RobotBody.mat",
"save": true,
"properties": {
"base_color": [0.8, 0.2, 0.1, 1.0],
"roughness": 0.45,
"metalness": 0.1,
"color_map": "app:/data/Textures/albedo.etex"
}
}
| Purpose | Path |
|---|---|
| PBR type / setters | engine/engine/rendering/material.h |
| Meta names | engine/engine/meta/rendering/standard_material.cpp |
| Model slots / instances | engine/engine/rendering/model.h |
| MCP helpers | editor/editor/system/mcp/mcp_material_utils.* |
| MCP tools | editor/editor/system/mcp/mcp_tools_materials.cpp |
| Inspector save | editor/editor/hub/panels/inspector_panel/inspectors/inspector_assets.cpp |
| Content Browser create | editor/editor/hub/panels/content_browser_panel/content_browser_panel.cpp |
materials_create_batch / materials_set (save).scene_set_model_material_instances_batch..mat → scene_set_model_materials_batch.require_edit_scene).