自动关联目录：Niagara 与 Gameplay 的交互

1. 定位

特效很少是纯装饰——它常常需要知道"伤害多少、目标是谁、朝向哪里"。这一篇讲的就是这条数据通路。

一句话定位：外部驱动特效靠"用户参数"，特效驱动游戏靠"事件"——两个方向的机制完全不同。

2. 游戏 → 特效（设置参数）

// C++
UNiagaraComponent* NC = ...;
NC->SetNiagaraVariableFloat(TEXT("User.Damage"), FinalDamage);
NC->SetNiagaraVariableVec3(TEXT("User.HitLocation"), HitLocation);

// 蓝图：Set Niagara Variable (Float / Vec3 / ...)

"设置了但没反应"的头号原因：参数不是 User. 命名空间，或没有在 Niagara 资产里声明。

3. 数据接口（Data Interface）

Niagara 的 Data Interface 让特效可以访问引擎数据源：

Data Interface 是使用成本要单独评估的一类——某些（如骨骼网格采样）开销明显。

4. 特效 → 游戏（事件）

典型用法：特效播完 → OnSystemFinished → 执行逻辑（如销毁物体、触发伤害）。

注意：不要依赖特效来做权威判定（特效可以丢、可以延迟）。判定必须在服务端（见 GameplayCue 的同样原则）。

5. 与 GAS / 技能的关系

技能激活 → Apply GE → GameplayCue → 播放 Niagara 特效
                              │
                              └─ 通过参数传入伤害/目标等

表现层（特效、音效、Cue）不应参与逻辑判定，这是 GAS 与网络预测能成立的前提。

6. 代价与权衡

7. 踩坑与排查

8. 排查顺序

1. 参数没生效？→ 命名空间 → 是否声明暴露 → 设置时机
2. 需要读引擎数据？→ 选合适的 Data Interface，评估开销
3. 特效要触发逻辑？→ 用事件/委托，但不做权威判定

参考

• Niagara 概览与系统结构 · Niagara 模拟与 GPU 粒子
• GameplayCue · Security