---name: shader-graph-create-custom-nodedescription: Generates custom Shader Graph nodes from HLSL code. Use when the user wants a new Shader Graph node or to make existing HLSL work as a reflected function node.required_packages: com.unity.shadergraph: >=17.5.0---

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"