ue5-blueprint-workflow

快速入门

• 确定目标 Blueprint 资产和图表（EventGraph 或函数图表）。
• 确认所需行为遵循“事件 -> 逻辑 -> 输出”链路。
• 先决定输入路径：旧版按键事件或 Enhanced Input 操作事件。
• 先给出图表级步骤，再提供精确的节点／引脚连线细节。

API 锚点（UE5.6-UE5.8）

• 键盘和事件节点锚点：
  • UK2Node_InputKey、UK2Node_InputAction、UK2Node_InputActionEvent
  • UK2Node_CallFunction、UK2Node_CustomEvent
• Enhanced Input 锚点：
  • UInputAction、UInputMappingContext
  • UEnhancedInputLocalPlayerSubsystem::AddMappingContext(...)
  • UEnhancedInputLocalPlayerSubsystem::RemoveMappingContext(...)
  • UEnhancedInputComponent::BindAction(...)
• 工具快捷路径锚点（首选用于自动化编辑 Blueprint）：
  • 使用 operation=add_input_key_event 调用 blueprint_modify
  • 使用 operation=connect_pins 调用 blueprint_modify
  • 使用 blueprint_query 检查引脚并验证编译

图表阶段规范

• 每项所需的 Blueprint 功能都必须指定：
  • 入口事件来源（按键／输入操作／自定义事件）
  • 核心逻辑节点（至少两个有实际意义的节点）
  • 必需的引脚级连接（执行引脚和数据引脚）
  • 输出／副作用（状态变化、调用、生成、UI）
  • 验证方法（编译状态、节点／引脚检查、预期执行顺序）
• 缺少任何一项，图表实现就不完整。

工作流

1）入口事件

• 键盘请求：优先使用 add_input_key_event，并设置 reuse_existing=true。
• Enhanced Input 请求：添加／复用 Input Action 事件节点（使用 UK2Node_InputActionEvent 路径）。
• 在尝试专用输入操作之前，不要泛泛猜测事件节点。

2）核心逻辑链

• 使用明确的控制流（Branch、Sequence、函数调用）构建最精简且确定的逻辑。
• 优先使用图表中已有的变量／函数，避免创建冗余节点。
• 每个行为分支都保持一条清晰的执行路径。

3）引脚连线

• 先连接执行引脚，再连接数据引脚，以固定执行顺序。
• 在使用 connect_pins 之前，通过 blueprint_query 检查确切的引脚名称。
• 存在多个重载引脚时，避免模糊的自动连线。

4）状态／输出

• 先应用状态更新（变量／标签），再执行副作用（生成／调用／UI 反馈）。
• 按用途隔离输出节点，以便后续调试。
• 同时存在成功／失败路径时，明确连接两条路径。

5）验证与总结

• 连线后验证编译状态和引脚完整性。
• 确认相同按键／操作没有重复的输入节点。
• 按确定顺序总结最终链路：入口 -> 分支 -> 操作 -> 输出。

约束

• 必须遵守快捷键规则：键盘功能优先使用 add_input_key_event。
• 按键事件保持 reuse_existing=true，以避免重复节点。
• 存在专用操作时，避免通过试错猜测节点类。
• 在最终输出中将图表步骤与引脚级细节分开。
• 对于新的输入系统，优先使用 Enhanced Input 资产（UInputAction／UInputMappingContext）。
• 除非明确要求，否则避免在潜在等待／计时器节点中隐藏行为。

故障处理

• 症状：按键未触发。
  • 定位：输入节点类型、重复的按键节点、输入焦点/上下文。
  • 修复：通过 add_input_key_event 复用/创建节点，移除重复节点，并确认映射上下文路径。
• 症状：图表编译时有警告，但行为不正确。
  • 定位：分支条件和执行引脚顺序。
  • 修复：调整执行链顺序，并检查条件数据引脚。
• 症状：自动化过程中引脚连接失败。
  • 定位：节点变体的引脚名称或重载不匹配。
  • 修复：连线前运行 blueprint_query 检查确切的引脚。
• 症状：Enhanced Input 事件已存在，但始终不会触发。
  • 定位：映射上下文注册和操作绑定路径。
  • 修复：确保已添加映射上下文，且操作事件节点与操作资源匹配。
• 症状：事件意外触发多次。
  • 定位：重复的入口节点或重复的绑定路径。
  • 修复：将入口节点合并为一个，并使用状态标志防止路径重入。
• 症状：编辑后图表无法编译。
  • 定位：替换节点后出现的断开链接，或过期的函数签名。
  • 修复：重新连接必需的引脚，并刷新函数节点签名。

UE5.6-UE5.8 兼容性说明

• 上述核心 Blueprint 图表节点在 UE5.6-UE5.8 中保持稳定。
• UE5.8 新增了 Enhanced Input UI Input Debugger；如可用，请使用该工具，同时确保日志和映射上下文检查仍适用于 5.6/5.7。
• 对所有受支持版本的新实现，优先采用 Enhanced Input 路径。

升级处理

• 当行为需要 C++ 扩展、自定义潜在节点或引擎插件变更时，升级处理。
• 当 Blueprint 已锁定、损坏，或因无关的项目错误而无法编译时，升级处理。