DFX3xxx — 声明与文档结构
DFX3xxx 段的全部诊断码，每条带严重级别、逐字消息、成因与修法。
DFX3xxx —— 声明与文档结构
生成标记之间的区块由
.skill/gen-diagnostics.ps1写入。 标记下方的所有内容均为手工撰写，在重新生成后依然保留。
DFX3000
严重级别 错误
消息
(built at runtime)触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:1930, Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:1941
原因. Root="..." 没有指向一个已挂载的内容根，或者 Name="..." 最后一个斜杠后面没有资产名。
修复. Root 取 Game、空串或 Plugin.<PluginName>。Name 是一条以资产名结尾的路径，例如 Systems/NS_Spark。
DFX3001
严重级别 错误
消息
(built at runtime)触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:1519
原因. 模块名在搜索路径上解析不到任何东西。这与 DFX3003 是两回事 —— 那个意思是模块存在，但没有这个输入 —— 否则路径打错和实参打错读起来会一模一样。
修复. 把目录加进 Settings.ModulePaths，或者写完整资产路径。dfx list 会打印当前路径上的每一个模块。
DFX3002
严重级别 错误
消息
Could not read the input schema of module '%s': %s触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:1560, Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:1613
原因. 模块找到了，但它的输入签名读不出来。schema 是靠把模块加进一个临时系统探测的，所以这通常意味着这个模块不能待在它被写进去的那个栈里。
修复. 检查栈。dfx schema <Module> -Stack <Stack> 会复现这趟探测。
DFX3003
严重级别 错误
消息
Module '%s' has no input named '%s'.%s Available inputs: %s触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:1677
原因. 这个模块没有叫这个名字的输入。Niagara 的输入名带空格（Loop Duration）；DreamFX 两侧都归一化，所以 LoopDuration 能匹配上，但拼错的匹配不上。
修复. 用列出来的名字之一。差一点的会给出建议。dfx schema <Module> 打印完整签名，包括藏在静态开关后面的输入。
DFX3004
严重级别 错误
消息
Unknown renderer type '%s'. Expected one of SpriteRenderer, MeshRenderer, RibbonRenderer, LightRenderer, DecalRenderer, ComponentRenderer, VolumeRenderer, or any UNiagaraRendererProperties subclass.触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:1740
原因. 渲染器类型是一个闭集。
修复. 用列出来的类型之一。渲染器属性是 schema 驱动、开放的（L8），固定的只有类型关键字。
DFX3005
严重级别 错误
消息
Emitter '%s' is declared more than once. Emitter names are stable keys and must be unique.触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:2117
原因. 两个发射器同名。名字是重建契约用来匹配 handle 的稳定键（plan 4.5），所以重名是数据丢失，不是命名洁癖。
修复. 改掉一个。要给一个已经存在于资产里的发射器改名，先用 dfx rename，这样 handle 和它的快速迭代参数才能活下来（R4）。
DFX3006
严重级别 错误
消息
'%s' is neither an allowed inline function (%s) nor a dynamic input: %s触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:1183
原因. 值位置上的一个调用，既不在 L6 的内置白名单里，也不对应任何 dynamic input 资产。
修复. 用列出来的内置函数之一、引用一个真实的 dynamic input，或者把这段数学写进 hlsl { } 块。放宽白名单是设计决定（L6），不是配置项。
DFX3007
严重级别 错误
消息
Could not read the input schema of dynamic input '%s': %s触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:1225
原因. dynamic input 资产找到了，但签名读不出来。
修复. dfx schema <Name> 会对同一个资产复现这次读取。
DFX3008
严重级别 错误
消息
Dynamic input '%s' has no input named '%s'. Available inputs: %s触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:1277
原因. 这个 dynamic input 没有叫这个名字的输入 —— 也就是链条下一层的 DFX3003。
修复. 用列出来的名字之一。
DFX3009
严重级别 错误
消息
Dynamic input '%s' is pinned to version %s, which its asset does not offer. Available version(s): %s.触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:1207, Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:1542
原因. 一个 R7 @version 固定与模块资产暴露的版本对不上，或者固定到了一个从未启用版本化的资产上。这个固定记录的是源码是照哪个版本写的；DreamFX 建不出别的版本，因为外部编辑 API 没有选版本的办法。
修复. 照暴露出来的版本重测并更新固定值，或者把资产上的那个版本恢复回来；模块本来就没有版本化的话，把 @ 去掉。
DFX3010
严重级别 错误
消息
Property '%s': %s触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:1145, Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:2051, Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:337
原因. 某条 Properties 声明的形状不对 —— 看内层消息。
修复. 修那条声明。可用类型列在 DFX4021 的消息里。
DFX3020
严重级别 错误
消息
Cannot read the default for %s setting '%s'.触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:1965, Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:737, Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:766
原因. 一个设置键不受支持，或者生成器无法从当前引擎读取某个映射设置在全新资产上的默认值。后者会阻止用已被移除设置的陈旧值进行重建。
修复. 对于未知的键，使用诊断中列出的受支持名字之一。如果读取默认值失败，检查随附的引擎/探测错误，并报告引擎版本和设置名；重建需要一份有效的默认 schema。
DFX3021
严重级别 错误
消息
User parameter '%s' is declared more than once.触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:1998
原因. 两个用户参数同名；蓝图的 SetNiagaraVariable 会打到赢的那一个上。
修复. 改掉一个。
DFX3030
严重级别 错误
消息
A Module or DynamicInput must declare Settings.Usage -- it decides which stacks the module can be placed in.触发位置 Source/DreamFXEditor/Private/Lint/DreamFXLint.cpp:186
原因. Usage 决定一个模块能被放进哪些栈。没有它，模块存在，但从任何栈都够不着。
修复. 加上 Usage = ParticleUpdate;（或别的栈）。数组可以选多个：Usage = [ParticleSpawn, ParticleUpdate];
DFX3031
严重级别 错误
消息
A DynamicInput must declare Settings.Output -- its return type cannot be inferred from the body.触发位置 Source/DreamFXEditor/Private/Lint/DreamFXLint.cpp:194
原因. dynamic input 的返回类型没法从它的 body 推出来。
修复. 加上 Output = float;（或它实际返回的类型）。
DFX3032
严重级别 错误
消息
A DynamicInput's Usage must be DynamicInput or a nonempty array of stack names.触发位置 Source/DreamFXEditor/Private/Lint/DreamFXLint.cpp:218
原因. 一个 DynamicInput 声明了无效的 Usage 值：一个裸栈名、一个空数组，或者一个包含未知栈名的数组。
修复. 用 Usage = DynamicInput; 取它默认的栈掩码，或者用一个非空栈数组（例如 Usage = [SystemSpawn, SystemUpdate];）来选择该输入在哪些地方可用。
DFX3033
严重级别 错误
消息
Input '%s' is declared more than once.触发位置 Source/DreamFXEditor/Private/Lint/DreamFXLint.cpp:228
原因. 两个输入同名，会在同一个 Module. 参数上撞车。
修复. 改掉一个。
DFX3034
严重级别 错误
消息
Input '%s' is marked [StaticSwitch] but is a %s. A static switch must be a bool, an int or an enum.触发位置 Source/DreamFXEditor/Private/Lint/DreamFXLint.cpp:243
原因. R5：静态开关在编译期求解，所以它必须是开关能分支的东西。
修复. 改成 bool、int 或枚举 —— 或者把 [StaticSwitch] 去掉。
DFX3035
严重级别 错误
消息
Input '%s' is a [StaticSwitch], so its default must be a compile-time constant.触发位置 Source/DreamFXEditor/Private/Lint/DreamFXLint.cpp:249
原因. 同一条 R5 的另一面：编译期求解的开关不能取运行时的值。
修复. 给它一个字面量默认值。
DFX3036
严重级别 错误
消息
The Body block is empty.触发位置 Source/DreamFXEditor/Private/Lint/DreamFXLint.cpp:258
原因. 空 body 生成出来的模块占着一个栈位，什么都不做。
修复. 把 body 写了，或者把文件删了。
DFX3037
严重级别 错误
消息
(built at runtime)触发位置 Source/DreamFXEditor/Private/Generation/DreamFXModuleGenerator.cpp:1054
原因. dynamic input 的 body 不是单个表达式。Niagara 翻译器会把它包成 Output = (Type)( <body> );，所以 return 之前的语句只会产出无效 HLSL，而不是一条说清真正问题的错误。
修复. 折成一个表达式，或者改写成 Module —— 模块的 body 逐字输出，想写多少条语句都行。
DFX3038
严重级别 错误
消息
'%s' is not a stack a module can be placed in. Use one of: %s.触发位置 Source/DreamFXEditor/Private/Generation/DreamFXModuleGenerator.cpp:931
原因. Usage 只能取六个栈之一（L1），别的都不行。
修复. 用列出来的名字之一。
DFX3039
严重级别 错误
消息
A DynamicInput cannot return a data interface; its Output must be a value type.触发位置 Source/DreamFXEditor/Private/Generation/DreamFXModuleGenerator.cpp:972
原因. dynamic input 是往输入槽里喂一个值，而数据接口不是值。
修复. 返回一个值类型。数据接口在 Properties 里声明，在运行时喂入（计划 3.5）。
DFX3040
严重级别 错误
消息
(built at runtime)触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:2136
原因. from 路径在磁盘上没解析到 .dfe。
修复. 路径先相对引用它的文件解析，再相对每一个 DFX 根解析。扩展名可省。
DFX3041
严重级别 错误
消息
'%s' could not be parsed; see the errors above.触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:2149
原因. 被引用的 .dfe 自己有错；那些错在这一条之前、按 .dfe 自己的路径报出来了。
修复. 去修那个 .dfe。它的诊断带的是它自己的文件和行，不是宿主的。
DFX3042
严重级别 错误
消息
'%s' declares a %s, but 'from' needs an Emitter document.触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:2159
原因. from 拉进来的是一个 emitter，而被引用的文件声明的是别的东西。
修复. 让 from 指向一个 .dfe。
DFX3043
严重级别 错误
消息
'%s' reads user parameters this system does not declare: %s. Add them to the Properties block.触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:1916
原因. .dfe 是按拷贝合并的（R3），它读的 User.* 一起被拷过来。宿主必须声明这些参数，否则拷进来的 emitter 会去读一个不存在的参数。诊断指在 from 那一行，因为决定是在那里做的。
修复. 把点名的那些参数加进宿主的 Properties 块。
DFX3044
严重级别 错误
消息
The default for input '%s' has to be a literal or an enum entry. A module input default is stored on the asset, so it cannot reference anything outside the module.触发位置 Source/DreamFXEditor/Private/Generation/DreamFXModuleGenerator.cpp:1007
原因. 模块输入的默认值存在资产上，所以它引用不到模块外面的任何东西。
修复. 用字面量或枚举项。想让调用方提供，就把它留着，在调用点设。
DFX3046
严重级别 错误
消息
'%s' is not a particle attribute DreamFX knows the type of. Write its type at first use, for example `float %s = ...;`.触发位置 Source/DreamFXEditor/Private/Generation/DreamFXModuleGenerator.cpp:623
原因. .dfm body 碰到了一个 Particles.* 属性，它既不是常见的 Niagara 属性，也没在 body 里声明过。给它接的引脚需要一个类型，而猜出来的类型会把引脚接成错误的宽度。
修复. 在第一次使用处写上类型，和 .dfs 声明新属性一样：float Particles.Moon.Phase = 0.0;
DFX3047
严重级别 错误
消息
A DynamicInput computes a value; it cannot write '%s'. Move the write into a Module.触发位置 Source/DreamFXEditor/Private/Generation/DreamFXModuleGenerator.cpp:1043
原因. dynamic input 是在输入槽里算一个值，它在栈里没有落脚点可以往外写。
修复. 把写入挪进一个 Module。
DFX3048
严重级别 错误
消息
Default override '%s' changes its type from %s to %s. Overrides must keep the base parameter's type.触发位置 Source/DreamFXEditor/Private/Generation/DreamFXEmitterMerge.cpp:84
原因. 一个使用 from 的 emitter，用不同的类型覆盖了基础 Defaults 参数。基础栈仍可能按原来的类型读取该参数。
修复. 覆盖参数值时保持基础参数的类型。如果需要不同的类型，请使用单独的参数名。
DFX3049
严重级别 错误
消息
MeshRenderer has no Material property. Set OverrideMaterials = [\"/path/to/material\"]; and bOverrideMaterials = true; to override its mesh materials.触发位置 Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:1791
原因. MeshRenderer 声明了 Material，但网格体材质由其覆盖数组和启用开关控制。
修复. 把 Material 替换为 OverrideMaterials = ["/path/to/material"]; 并设置 bOverrideMaterials = true;。
DFX3050
严重级别 错误
消息
(built at runtime)触发位置 Source/DreamFXEditor/Private/Generation/DreamFXSystemInheritance.cpp:138
原因. 系统的 Parent 引用无法解析到一个 .dfs 源文件。
修复. 修正父源路径，并确保被引用的 .dfs 文件存在于受支持的源位置。
DFX3051
严重级别 错误
消息
Only a System document can inherit a .dfs parent.触发位置 Source/DreamFXEditor/Private/Generation/DreamFXSystemInheritance.cpp:131、Source/DreamFXEditor/Private/Generation/DreamFXSystemInheritance.cpp:154、Source/DreamFXEditor/Private/Generation/DreamFXSystemInheritance.cpp:161
原因. 父源无法解析、没有声明 System，或者正被一个非 system 文档继承。
修复. 只在 .dfs system 文档之间使用 system Parent 继承，并修复为父文件报告的任何诊断。
DFX3052
严重级别 错误
消息
System inheritance contains a cycle or exceeds 128 sources: %s -> %s.触发位置 Source/DreamFXEditor/Private/Generation/DreamFXSystemInheritance.cpp:144
原因. 系统的父链重复访问同一个源文件，或超过了 128 个源的限制。
修复. 移除诊断中显示的循环父引用，或缩短继承链。
DFX3053
严重级别： 错误 (error)
消息：
Inherited parameter '%s' changes type from %s to %s. An override must preserve the parent's parameter type.触发位置： Source/DreamFXEditor/Private/Generation/DreamFXSystemInheritance.cpp:74
原因. 子系统用不同的 Niagara 类型重新声明了一个继承来的参数。
修复. 覆盖参数值时保持父级的参数类型，或者给新参数换一个名字。
DFX3054
严重级别： 错误 (error)
消息：
Parameter '%s' is declared twice in one inheritance layer. An override must be declared in the child source, not twice in the same source.触发位置： Source/DreamFXEditor/Private/Generation/DreamFXSystemInheritance.cpp:22, Source/DreamFXEditor/Private/Generation/DreamFXSystemInheritance.cpp:34
原因. 系统继承链中的某一个源把同一个参数名或 emitter 名声明了不止一次。
修复. 每个源文件里每个名字只保留一条声明，继承来的覆盖放进子源里。
DFX3055
严重级别： 错误 (error)
消息：
(built at runtime)触发位置： Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:2197, Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:2203
原因. 某个 emitter 的 inherits 路径解析不到一个已启用继承的独立 Niagara emitter 资产。
修复. 修正资产路径并在那个 emitter 上启用继承，或者当预期的父级是 DreamFX 源时改用 from "...dfe"。
DFX3056
严重级别： 错误 (error)
消息：
Native parent has an unavailable version or a cyclic parent chain: %s.触发位置： Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:2216, Source/DreamFXEditor/Private/Generation/DreamFXGenerator.cpp:2223
原因. 原生 emitter 的父链里有一个不可用的版本、一个循环，或者有未合并的祖先改动。
修复. 选一个已存在的版本 GUID，去掉任何父链循环，并在重建前先在 Niagara 里合并并保存待处理的祖先改动。
DFX3057
严重级别： 错误 (error)
消息：
Attribute '%s' is declared with conflicting types.触发位置： Source/DreamFXEditor/Private/Generation/DreamFXModuleGenerator.cpp:570, Source/DreamFXEditor/Private/Generation/DreamFXModuleGenerator.cpp:577, Source/DreamFXEditor/Private/Generation/DreamFXModuleGenerator.cpp:695
原因. 一个 .dfm 自定义属性类型互相冲突、在自己初始化期间被读取，或者首次初始化发生在一个可能不会执行到的路径上。
修复. 新属性要在控制流之前给它一个无条件的整体值初始化器；要更新由更早模块提供的自定义属性，就只声明它的类型而不带初始化器，并保持后续类型一致。
DFX3045
历史诊断。 当前源代码树已不再发出此代码。保留本节是为了让较旧的诊断链接仍然可用；它不属于生成的活动代码列表。
先前的错误为：
'%s' is not a type a particle attribute can have.它描述了在 .dfm body 中声明了一个粒子属性，使用了不是 Niagara 值类型的类型。历史上的修复方法是使用受支持的 DSL 值类型，例如 float、int、bool、Vector2、Vector、Vector4、Color、Position 或 Quat。有关当前的编写规则，请参阅模块和动态输入以及值和类型。