version: "1.0.4" 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.