快速开始
安装与启用
在 Unreal 项目中启用 DreamShader，并准备 DreamShaderLang 源目录。
DreamShaderLang 由 Unreal 插件 DreamShader 编译。写语言文件前，需要先让 Unreal 项目能发现插件和 DShader 源目录。
前置条件
| 项目 | 要求 |
|---|---|
| Unreal 项目 | 插件放在项目 Plugins/DreamShader 下。 |
| 源文件根目录 | 默认是项目根目录下的 DShader。 |
| 文件扩展名 | .dsm 和 .dsh。 |
| 自动编译 | 默认开启，保存源文件后生成或刷新资产。 |
基本步骤
- 将插件目录放入 Unreal 项目的
Plugins/DreamShader。 - 在 Unreal Editor 中启用 DreamShader 插件。
- 重启 Unreal Editor。
- 在项目根目录创建
DShader。 - 在
DShader/Materials创建第一个.dsm文件。 - 保存文件，等待插件生成
UMaterial或UMaterialFunction。
Project Settings
打开 Project Settings > Plugins > DreamShader 可以配置：
| 设置 | 默认值 | 说明 |
|---|---|---|
SourceDirectory | DShader | DreamShaderLang 源文件根目录。 |
GeneratedShaderDirectory | 可配置 | 普通 Function 生成 helper include 的位置。 |
AutoCompileOnSave | true | 保存 .dsm / .dsh 时自动刷新资产。 |
SaveDebounceSeconds | 0.25 | 保存防抖时间。 |
VerboseLogs | false | 输出详细日志。 |
手动重编
VSCode 扩展提供命令：
DreamShaderLang: Recompile Current Source
DreamShaderLang: Recompile All DSM对 .dsh 执行当前文件重编时，会扩展为重编依赖它的 .dsm，而不是尝试从 .dsh 直接生成资产。
生成位置
Shader(Name="DreamMaterials/M_Minimal") 会解析成 /Game/DreamMaterials/M_Minimal.M_Minimal。语言中的 Name 不需要写 /Game 前缀，生成器会把它作为项目内容目录下的 package path 处理。