unity-decal
GitHub用于在Unity URP中创建、配置和管理Decal Projector贴花及渲染器特性。支持查询、批量修改属性及确保渲染特性启用，适用于添加或编辑贴花场景。
Trigger Scenarios
Install
npx skills add Besty0728/Unity-Skills --skill unity-decal -g -y
SKILL.md
Frontmatter
{
"name": "unity-decal",
"description": "Create and configure URP Decal Projectors plus DecalRendererFeature setup — project decals onto surfaces and wire the renderer feature. Use when adding decals in URP, configuring a Decal Projector, or enabling the Decal Renderer Feature, even if the user just says \"贴花\" or \"decal\". 创建与配置 URP Decal Projector 并设置 DecalRendererFeature(将贴花投射到表面、接入渲染器特性);当用户要在 URP 中添加贴花、配置 Decal Projector 或启用 Decal Renderer Feature 时使用。"
}
Decal Skills
URP Decal Projector creation and configuration (URP only; HDRP decal APIs are not covered here).
Operating Mode
- Query skills (
decal_get_info,decal_find_all) areSkillMode.SemiAuto— they run in all three modes without grant. - Mutating skills (
decal_create,decal_set_properties,decal_set_properties_batch,decal_ensure_renderer_feature) areSkillMode.FullAuto— under Approval they need user grant (grant triggers one server-side execute returning the result); under Auto / Bypass they execute directly. decal_deletecarriesSkillOperation.Deleteand 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.
Guardrails
Routing:
- For renderer feature management in general:
urp - For DecalProjector scene operations: this module
Runtime-first rules:
- Call
decal_ensure_renderer_featurebefore assuming the current URP renderer is decal-ready - Use
decal_get_info/decal_find_allto discover real projector state before editing decal_set_properties_batchexpectsitemsto be a JSON array string- This module targets the URP Decal workflow first; do not assume HDRP decal APIs are covered here
Skills
decal_create
Create a Decal Projector.
decal_get_info
Inspect a Decal Projector.
decal_set_properties
Modify Decal Projector properties.
decal_find_all
List Decal Projectors in the scene.
decal_delete
Delete a Decal Projector GameObject.
decal_set_properties_batch
Batch-edit Decal Projectors.
decal_ensure_renderer_feature
Ensure the target URP renderer has a DecalRendererFeature.
Exact Signatures
Exact names, parameters, defaults, and returns are defined by GET /skills/schema or unity_skills.get_skill_schema(), not by this file.
Version History
- ec9f870 Current 2026-07-05 14:39
