安装插件

DreamShader 作为 Unreal 项目插件使用。安装后，项目可以识别 .dsm / .dsh 源文件，并在保存或手动重编时生成材质资产。

获取插件

公开仓库：

https://github.com/TypeDreamMoon/DreamShader

可以通过 Git 克隆或下载源码包，再放入 Unreal 项目的插件目录。目录名建议保持为 DreamShader，便于团队成员和文档统一。

启用流程

1. 将插件加入 Unreal 项目。
2. 在 Unreal Editor 的插件面板中启用 DreamShader。
3. 重启 Unreal Editor。
4. 创建 DreamShaderLang 源目录，默认名称为 DShader。
5. 创建 .dsm 或 .dsh 源文件。
6. 保存源文件或使用 VSCode 扩展命令触发重编。

项目设置

打开 Project Settings > Plugins > DreamShader 可以看到插件配置。

验证安装

创建一个最小 .dsm：

Shader(Name="DreamMaterials/M_InstallCheck")
{
    Settings = {
        Domain = "UI";
        ShadingModel = "Unlit";
    }

    Outputs = {
        vec3 Color;
        Base.EmissiveColor = Color;
    }

    Graph = {
        Color = vec3(0.2, 0.6, 1.0);
    }
}

保存后，如果项目中生成了对应 UMaterial，说明插件编译链路正常。

注意事项