枚举取值

三个 Settings 键取引擎枚举：ShadingModel、BlendMode（也可写 RenderType）和 MaterialDomain（也可写 Domain）。它们不走通用的 反射枚举匹配 —— 它们有自己的别名表，本页完整列出。

Settings [=] {
    [ShadingModel                 = <shading-model>;]
    [{ BlendMode | RenderType }   = <blend-mode>;]
    [{ MaterialDomain | Domain }  = <domain>;]
}

值是怎么匹配的

1. 值先规范化：trim、小写，再删除所有空格、_ 和 -。
2. 先扫描该键的项目映射表。第一个规范化键命中即胜出并立即返回 —— 项目条目会覆盖内置拼写， 不会继续回落。
3. 只有在没有项目条目命中时，才构建并同样扫描内置表。
4. 命中的值若是枚举的 _MAX 哨兵，算作失败；所以指向 MSM_MAX / BLEND_MAX / MD_MAX 的项目条目会让那个拼写不再解析成功。

由于第 1 步，"Default Lit"、"DefaultLit"、"default_lit"、"DEFAULT-LIT" 是同一个别名。 下面的表列的是插件注册的原始拼写，每个拼写的各种分隔符变体同样有效。

内置表分两阶段构建：反射阶段遍历引擎枚举并剥掉枚举项前缀，显式阶段再补上手写拼写。 显式阶段不会用相同的键覆盖反射阶段的条目，所以有几行显式条目其实是保留下来便于阅读的空操作。

ShadingModel

从 EMaterialShadingModel 反射而来，剥掉 MSM_ 前缀。

在 UE 5.4 – 5.8 上共 15 个不同的规范化别名；UE 5.3 上是 13 个，因为它既没有 strata 也没有 substrate。

被排除的：MSM_NUM、MSM_MAX，以及被刻意排除的 MSM_FromMaterialExpression。 写 ShadingModel = "FromMaterialExpression"; 是错误，它不是从图里驱动 shading model 的办法。

BlendMode

从 EBlendMode 反射而来，剥掉 BLEND_ 前缀。键也可以写作 RenderType。

在原版 UE 5.4 – 5.8 上共 12 个不同的规范化别名。TranslucentColoredTransmittance 是 Substrate 专有枚举项，所以这个数量与引擎版本相关。

被排除的：BLEND_MAX，以及两个被引擎标记为 hidden 的枚举项 —— BLEND_TranslucentGreyTransmittance 和 BLEND_ColoredTransmittanceOnly。它们都是表中已有值的别名， 所以没有任何值因此不可达。

Domain

从 EMaterialDomain 反射而来，剥掉 MD_ 前缀。键也可以写作 MaterialDomain；两者同时出现时它胜出。

共 10 个不同的规范化别名，在 UE 5.3 – 5.8 上保持稳定。

被排除的：MD_MAX。其他 hidden 枚举项都会跳过，MD_RuntimeVirtualTexture 是唯一刻意的例外 —— 引擎把它标为 hidden，插件保留了它。

添加项目专属拼写

项目设置上有三个 TMap 属性用来扩展这些表。它们位于 Project Settings ▸ DreamPlugin ▸ Dream Shader ▸ Mappings，且默认为空 —— 上面的内置表从不写进这三个 map，所以面板是空的并不代表“没有别名”。

键在规范化后比较，所以条目里的大小写、空格、下划线和连字符都无关紧要。

备注

• 反射阶段遍历的是编译进引擎的枚举内容。改过的引擎会自动贡献它自己的值：一个新增了 MSM_Toon 的引擎，不用改插件也不用配项目映射，ShadingModel = "Toon"; 就能用。上面的表描述的是原版 UE 5.3 – 5.8。
• 插件自己做版本门控的只有 Strata / Substrate，它们只在 UE 5.4 及以上注册。
• 带 Hidden 元数据的值只在保留编辑器数据的构建里被过滤。材质生成本来就是编辑器专用的， 所以实际生效的正是这种配置。
• Saved/DreamShader/Bridge/settings.json 会导出这些表供编辑器补全使用。它按规范化别名去重， 所以里面有 "Default Lit" 而没有 "DefaultLit"。两者都能编译 —— 那份清单是补全用的， 不是接受集合。
• 不写某个键不会保留上次的值：重新生成的材质会先被重置为 Opaque / DefaultLit / Surface。 见材质 Settings。

诊断

这四条都在校验阶段抛出，早于对材质的任何写入。

示例

Shader(Name="Docs/M_EnumSpellings")
{
    Properties { vec3 Tint = vec3(0.9, 0.2, 0.1); }

    Settings {
        Domain       = "User Interface";   // -> MD_UI
        ShadingModel = "Lit";              // -> MSM_DefaultLit
        RenderType   = "Premultiplied";    // -> BLEND_AlphaComposite
    }

    Outputs {
        vec3  Color;
        float Alpha;
        Base.EmissiveColor = Color;
        Base.Opacity       = Alpha;
    }

    Graph {
        Color = Tint;
        Alpha = 0.75;
    }
}

生成后的材质状态：

MaterialDomain = MD_UI
ShadingModel   = MSM_DefaultLit
BlendMode      = BLEND_AlphaComposite

下一步

• 材质 Settings —— 这些值所属的键
• 项目设置 —— 三张映射表
• Substrate 节点 —— UE 5.4+ 的 Substrate 面