项目里的布局

模块分层

运行时按层拆成几个模块。一个模块只依赖它下面各层的模块，从不依赖同层的兄弟；反方向的 include 会让 Tools/Tests/static_checks.py 失败（规则 layering）。UI 的六个运行时模块都在 PostConfigInit 加载， 所以它们的类型和 .dui 标签在任何东西编译之前就已就位。

L4   DreamGUISamples
L3   DreamGUIControls      DreamGUIExtensions
L2   DreamGUIInput
L1   DreamGUI (core)
L0   DreamGUIRenderer      DreamTween
     ------------------------------------------------------------
     DreamGUIEditor, DreamGUIK2Nodes (uncooked only), DreamGUITests (editor only)

C++ 要加哪个模块

用到哪个拆出去的模块里的类型，就把那个模块加进你的 Build.cs。大致的对应是：

// MyGame.Build.cs
PublicDependencyModuleNames.AddRange(new string[] { "DreamGUI", "DreamGUIInput", "DreamGUIControls" });

资产不需要做任何事：每个挪了模块的类型都仍然能用旧名字加载（见迁移）。

.dui 文件放在哪

放在一个 DUI/ 目录下：项目自己的（<Project>/DUI/），或者某个已启用插件的（<Plugin>/DUI/）。 不放在 Content/ 下 —— .dui 是源码，不是资产：放进 Content/ 意味着烹饪器要去走它，内容浏览器里多出一个打不开的文件， 而一个发布控件类的插件得把源码混进烹饪内容里才能被找到。

指向另一个文件的路径 —— 蓝图的 Source File，或者 use 后面那个 —— 有三种写法：

裸的相对路径意思是"哪个根有它就是哪个"，方便，但两个根里有同一个相对路径时就有歧义 —— 这正是插件限定写法存在的原因。 在设计器里选文件时，选到的绝对路径会被转回可移植的写法：项目根下的存成相对路径，插件根下的存成 Plugin.X:…， 都不在的才原样存成绝对路径（拒收会让选择框悄悄丢掉你的选择）。

use "Settings/SettingsLibrary.dui"
use "Plugin.MyPlugin:Panels/Row.dui" as Row
use /Game/UI/WBP_Slider as Slider

VerticalBox Root {
    Spacing = 12
    Row Audio { Label = "Audio" }
    Slider Volume
}

编辑器还会往项目的 DUI/ 里写两个文件：.dui-symbols.json（启动时和执行 DreamUI.ExportSymbols 时重写， 是 VS Code 扩展做补全用的符号表），以及 DreamUI.code-workspace（Tools ▸ Open DreamUI Workspace (VSCode) 按当前的源码根重写并打开）。

一个用了 DreamGUI 的项目大概是这样：

项目的 Config/DefaultDreamGUI.ini 存的是 Project Settings ▸ Plugins ▸ Dream GUI 的值（见安装）。

插件目录里有什么

Config

从 1.0.0 起插件不再带 CoreRedirects，按旧名字保存的资产怎么重存一次，见从开发版升级。

• Game.ini —— 把 /DreamGUI 加进 DirectoriesToAlwaysCook。插件自己伸手去拿的资产（默认材质、字体、精灵预设……） 是赋给原生 CDO 的软指针，不产生资产依赖；没有这一行，按显式包列表烹饪时它们一个也不会进包，整个 UI 画成空白。 文件必须叫 Game.ini 才会被并入 Game 分支。
• FilterPlugin.ini —— BuildPlugin 默认只打包 /Source、/Content、/Resources、/Shaders 和 /Binaries/ThirdParty；这里列出其余必须随插件走的文件：上面的 Game.ini、README、CHANGELOG、Docs/ 下的文档和参考、msdfgen 的源码与许可证。

Content

默认字体（DefaultFont_DistanceField 及其 _Bold、_Italic、_BoldItalic、_CJK 四个字面，还有 DefaultFont_Bitmap）、 Materials/ 下的材质与材质函数、精灵与纹理预设、Blueprints/ 下的事件系统 Actor、Controls/ 下的控件蓝图 （BP_Button、BP_Toggle、BP_Dropdown……）、EnhancedInput/ 下的输入动作和映射上下文（IA_*、IMC_DreamUIInputContext）， 以及 Samples/HelloDreamGUI.dui。

DShader

Content/Materials 的源码（.dsm / .dsf）。.uasset 是构建产物，和源码一起提交，所以 DreamGUI 不依赖 DreamShader： 没装 DreamShader 时，那些材质就是普通的 UMaterial 和 UMaterialFunction。只有想从文本重建它们时才需要 DreamShader。

Docs

DuiLanguage.md（整个 .dui 语言）、Migration.md、FontsAndPackaging.md，以及 Reference/ —— 逐类的属性与函数参考， 从反射打印出来、不是手写的，所以不会落后于头文件：

UnrealEditor-Cmd.exe <project>.uproject -run=DreamGUIReferenceDocs

本站的API 参考就是这些页面。

Resources

插件图标、编辑器图标，以及 UMGParity/：每个 UMG 类一张对照表（58 张），逐个成员说明它在这里是同名同义、换了名字或位置， 还是有意不提供以及为什么。自动化测试拿这些表和 UMG 自己的反射双向核对。见与 UMG 的区别和UMG 对照。

Shaders、Source、ThirdParty

Shaders/Private 是渲染器的 .usf / .ush；Source/ 是上面那十个模块；ThirdParty/ 是 msdfgen 的子模块和提交进来的单文件拷贝（见安装）。

Tools

日志类别

统计组是 stat DreamGUI（声明在渲染器里，渲染器和它之上的每个模块都往同一个组里计数）和 stat DreamTween。