Unreal 蓝图编程

你在解决什么问题

在 Unreal Engine 5 里用蓝图搭玩法逻辑时，常见问题不是「会不会拖节点」，而是图选错了、Construction Script 和 Event Graph 职责混用，以及 Blueprint 之间用 Cast 链把整棵资产树硬引用进内存。项目里有 *.uproject 和 Blueprint *.uasset、你主要在编辑器里可视化编排时，需要一套可重复的决策顺序，而不是凭感觉堆节点。

技能如何组织工作流

本技能按 UE 5.4+ 蓝图节点流描述（蓝图是节点图，下文讲的是图上的执行与数据流）：

1. 选 Blueprint 类型：可复用逻辑放在 Blueprint Class（Actor/Pawn/Character/ActorComponent 等）；Level Blueprint 只放关卡特有脚本，不要把应复用的逻辑写进关卡图。
2. Construction Script：编辑器放置/编辑时跑，用于按变量配置组件、程序化摆放等；不要在这里做运行时玩法（生成 Actor、启动逻辑应放到 BeginPlay）。
3. Event Graph：Event BeginPlay 做初始化；重叠、输入等事件驱动反应；除非真需要每帧更新，否则避免 Event Tick。
4. 暴露数据：变量用分类整理；需要实例上可调时打开 Instance Editable（眼睛图标）；纯 getter 用 pure 函数（无 exec 引脚）。
5. 通信按耦合选：你明确依赖的类型可用 Cast；跨类型调用用 Blueprint Interface；一对多用 Event Dispatcher。
6. 验证：Blueprint 调试器断点、观察变量，PIE 里用 Print String 确认执行路径。

Patterns 部分强调：优先事件/Timer/Timeline 的响应式 Event Graph；Cast 与 Interface、Dispatcher 的取舍；以及 Cast 链、Tick 滥用、Interface 目标未实现等 Pitfalls 的对照说明。更细的 Cast vs Interface vs Dispatcher 决策与 Dispatcher 绑定步骤见技能内 references/communication.md。

适用边界

不适合用本技能主导的场景：性能敏感系统、大型数据结构、需要 diff 友好与单元测试的逻辑 → 应转向 C++ 玩法（相关技能 unreal-cpp-gameplay）；玩家输入映射 → unreal-enhanced-input；AI 决策 → unreal-behavior-trees。蓝图 Debugger 能查执行路径，但替代不了上述领域的专用工作流。