用途:在 Unity URP 中创建和配置 Decal Projector(贴花投影器),并管理渲染器上的 Decal Renderer Feature。仅针对 URP,不覆盖 HDRP 贴花 API。
主要能力:decal_create 创建贴花投影器(可指定名称、材质路径与位置);decal_get_info 与 decal_find_all 查询投影器状态;decal_set_properties 与 decal_set_properties_batch 修改属性,包括 materialPath、drawDistance、fadeScale、fadeFactor、startAngleFade、endAngleFade、uvScale、uvBias、size、pivot、renderingLayerMask、scaleMode;decal_delete 删除投影器 GameObject;decal_ensure_renderer_feature 确保目标 URP 渲染器具备 DecalRendererFeature,已存在时返回 alreadyExists: true,可安全重复调用。
使用方式:查询类技能为 SemiAuto,三种模式下无需授权直接运行;修改类技能为 FullAuto,在 Approval 模式下需用户授权,在 Auto / Bypass 模式下直接执行;decal_delete 带 Delete 操作,在 Approval / Auto 模式下自动禁止,仅 Bypass 或用户管理的 Allowlist 可运行。定位对象需提供 name、instanceId、path 中至少一个。decal_set_properties_batch 的 items 需为 JSON 数组字符串。编辑前应先调用 decal_ensure_renderer_feature 确认渲染器就绪,并用 decal_get_info / decal_find_all 获取真实状态。
限制:未安装 com.unity.render-pipelines.universal 时所有技能返回 error: "Universal Render Pipeline package … is not installed." 的诊断占位,该占位不属于权限拒绝,也非 NeverInSemi。精确签名(名称、参数、默认值、返回值)以 GET /skills/schema 或 unity_skills.get_skill_schema() 为准。