| name | unity-urp |
| description | Manage the Universal Render Pipeline (URP) |
Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.
Triggers
- Configuring the URP asset
- Adding or editing renderer features
- Adjusting URP rendering settings
- 配置 URP 资产、添加或编辑渲染器特性、调整 URP 渲染设置
URP Skills
URP-specific asset and renderer feature management for Unity 2022.3+ (URP 14 and Unity 6 / URP 17).
Operating Mode
- Query skills (
urp_get_info, urp_list_renderers, urp_list_renderer_features) are SkillMode.SemiAuto — they run in all three modes without grant.
- Mutating skills (
urp_set_asset_settings, urp_add_renderer_feature, urp_set_renderer_feature_active) are SkillMode.FullAuto — under Approval they need user grant (grant triggers one server-side execute returning the result); under Auto / Bypass they execute directly.
urp_remove_renderer_feature carries SkillOperation.Delete and is auto-forbidden in Approval / Auto modes (NeverInSemi). Only Bypass or the user-managed Allowlist can run it.
URP Package Stub
This module is compiled against com.unity.render-pipelines.universal (URP). When URP is not installed, every skill returns a stub { error: "Universal Render Pipeline package … is not installed." } (RenderPipelineSkillsCommon.NoURP()). The stub is a diagnostic payload, not a permission denial — it does not require grant and is not treated as NeverInSemi. Call project_get_render_pipeline first when you see this error.
Guardrails
DO NOT:
- Use this module for ShaderGraph
- Assume arbitrary custom renderer features are safe to instantiate
- Assume Unity 2022 and Unity 6 expose the same built-in renderer features
Runtime-first rules:
- Always call
urp_get_info before urp_add_renderer_feature
- Only use names returned by
urp_get_info.creatableRendererFeatures
- Do not hardcode
RenderObjects, FullScreenPassRendererFeature, ScreenSpaceReflectionRendererFeature, etc. as universally available
- Use
urp_list_renderer_features to resolve existing feature names/indexes before calling urp_set_renderer_feature_active or urp_remove_renderer_feature
Validated behavior:
- Unity 2022.3 + URP 14 real environment may expose a smaller creatable set, e.g.
DecalRendererFeature and ScreenSpaceAmbientOcclusion
- Unity 6 + URP 17 real environment may expose a larger set
Skills
urp_get_info
Inspect the active URP asset and renderer layout.
urp_set_asset_settings
Modify key URP asset settings like HDR, MSAA, render scale, shadows, and camera textures.
urp_list_renderers
List renderer data assets on the active URP asset.
urp_list_renderer_features
List renderer features on a specific renderer.
urp_add_renderer_feature
Add a safe built-in renderer feature to a renderer.
urp_remove_renderer_feature
Remove a renderer feature from a renderer.
urp_set_renderer_feature_active
Enable or disable a renderer feature.
Exact Signatures
Exact names, parameters, defaults, and returns are defined by GET /skills/schema or unity_skills.get_skill_schema(), not by this file.