---
title: "MaterialFunction"
type: concept
tags: ["unreal-engine", "materials", "shader"]
sources: ["unreal-technical-artist"]
last_updated: 2026-04-26
---

## Definition
UE5 Material Editor 中可封装、可复用的节点逻辑单元。封装一组节点图作为黑盒函数，供多个 Master Material 引用。

## Purpose
消除跨 Master Material 的重复节点簇，确保同一逻辑只需维护一处。

## Usage in This Wiki
- [[unreal-technical-artist]] 强制规定：所有可复用逻辑必须封装为 Material Function，禁止在多个 Master Material 间重复节点簇
- 示例：MF_TriplanarMapping（三平面映射）封装 WorldPosition 投影逻辑，可在任意岩石、悬崖、地形混合材质中使用

## Key Principles
- 单一职责：一个 Function 只做一件事（三平面映射 / 噪声叠加 / 顶点偏移等）
- 输入输出清晰：所有可调参数通过 Input 节点暴露
- 禁止副作用：Function 内部不应修改外部状态
- 避免 Static Switch 嵌套：每个 Static Switch 使引用该 Function 的材质排列数翻倍

## Related
- [[MaterialEditor]] — Material Function 的创作环境
- [[QualitySwitch]] — 同一材质内的质量分层机制
- [[NiagaraVFX]] — VFX 系统，类似 Function 的模块化复用理念