Shader Graph Create Custom Node

by Unity-Technologiesba48956ae8beNo licenseListed Oct 8, 2026Updated Oct 8, 2026

Generates custom Shader Graph nodes from HLSL code. Use when the user wants to create a new Shader Graph node or make existing HLSL code work as a reflected function node.

Instructions onlySoftware Development
AI-generated overview

Generates custom Unity Shader Graph nodes from HLSL code with reflection hint tags.

What it does
This skill guides the creation of a custom Shader Graph node by turning HLSL code into a reflected function node. It defines the HLSL function with the UNITY_EXPORT_REFLECTION preprocessor define, decorates it with Shader Graph hint tags such as ProviderKey, SearchCategory, SearchTerms and DisplayName, and writes the code into a ShaderInclude (.hlsl) asset. It also checks the project for an existing asset containing custom nodes and asks for confirmation before appending.
When to use it
Use it when the user wants to create a new Shader Graph node or make existing HLSL code work as a reflected function node in Unity.
Requirements
Requires the Unity Shader Graph package com.unity.shadergraph version 17.5.0 or later. Instructions only; no scripts are shipped, though a reference file of hint tags is included.

Generating a custom Shader Graph node

Step 1: Generate an HLSL function definition

  • The function must be preceded by the preprocessor define UNITY_EXPORT_REFLECTION

Step 2: Decorate with Shader Graph hint tags

  • See resources/all_hints.hlsl for all valid hint tags and usage patterns
  • C#-style documentation tags are supported outside of funchints or paramhints blocks
  • Required function hints:
    • sg:ProviderKey
    • sg:SearchCategory
    • sg:SearchTerms
    • sg:DisplayName

Step 3: Write the code to an asset

  • Search the project for a ShaderInclude asset (.hlsl) that already contains custom Shader Graph nodes
  • If a matching asset exists, show the user its current contents and ask for confirmation before appending the new code
  • If no matching asset exists, create a new .hlsl asset
  • Ensure the file begins with #include "ShaderApiReflectionSupport.hlsl"

Source and attribution

Source:Unity-Technologies/unity-agent-plugininskills/shader-graph-create-custom-nodeat commitba48956

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal