unity-material

Unity Material Skills

Overview

BATCH-FIRST: Use *_batch skills when operating on 2+ objects/materials.

Common Mistakes

DO NOT (common hallucinations):

• material_set_metallic / material_set_smoothness do not exist → use material_set_float with propertyName="_Metallic" or "_Glossiness" (Standard) / "_Smoothness" (URP)
• material_set_color r/g/b/a range is 0–1, not 0–255
• material_set_property does not exist → use the specific setter: material_set_float, material_set_int, material_set_vector, material_set_color
• material_get_color does not exist → use material_get_properties (returns all properties including colors)

Routing:

• For shader changes → material_set_shader (this module)
• For texture tiling → material_set_texture_scale / material_set_texture_offset
• Pipeline-specific property names differ: check Render Pipeline Compatibility table in this doc

Object Targeting: Single-object skills accept name (GameObject name) or path (material asset path like Assets/Materials/X.mat). For asset-based operations, prefer path.

Recipe path rule: ../../recipes/material/<command>.md

Skills Overview

Single Object	Batch Version	Use Batch When
material_create	material_create_batch	Creating 2+ materials
material_assign	material_assign_batch	Assigning to 2+ objects
material_set_color	material_set_colors_batch	Setting colors on 2+ objects
material_set_emission	material_set_emission_batch	Setting emission on 2+ objects

No batch needed:

• material_set_texture - Set texture
• material_set_texture_offset/scale - Texture tiling
• material_set_float/int/vector - Set properties
• material_set_keyword - Enable/disable shader keywords
• material_set_render_queue - Set render queue
• material_set_shader - Change shader
• material_get_properties/keywords - Query properties
• material_duplicate - Duplicate material