ue5-blueprint-workflow

Quick Start

• Identify target Blueprint asset and graph (EventGraph or function graph).
• Confirm requested behavior as event -> logic -> output chain.
• Decide input route first: legacy key event or Enhanced Input action event.
• Produce graph-level steps first, then exact node/pin wiring details.

UE5.7 API Anchors

• Keyboard and event node anchors:
  • UK2Node_InputKey, UK2Node_InputAction, UK2Node_InputActionEvent
  • UK2Node_CallFunction, UK2Node_CustomEvent
• Enhanced Input anchors:
  • UInputAction, UInputMappingContext
  • UEnhancedInputLocalPlayerSubsystem::AddMappingContext(...)
  • UEnhancedInputLocalPlayerSubsystem::RemoveMappingContext(...)
  • UEnhancedInputComponent::BindAction(...)
• Tool fast-path anchors (preferred for Blueprint editing automation):
  • blueprint_modify with operation=add_input_key_event
  • blueprint_modify with operation=connect_pins
  • blueprint_query for pin inspection and compile checks

Graph Stage Contract

• Every requested Blueprint feature must specify:
  • Entry event source (key/input action/custom event)
  • Core logic nodes (minimum two meaningful nodes)
  • Required pin-level connections (exec and data pins)
  • Output/side effects (state change, call, spawn, UI)
  • Validation method (compile status, node/pin inspection, expected execution order)
• If any item is missing, the graph implementation is incomplete.

Workflow

1) Entry Event

• Keyboard requests: use add_input_key_event first with reuse_existing=true.
• Enhanced Input requests: add/reuse Input Action event nodes (UK2Node_InputActionEvent path).
• Do not perform generic event-node guessing before trying dedicated input operations.

2) Core Logic Chain

• Build minimal deterministic logic with explicit control flow (Branch, Sequence, function calls).
• Prefer existing graph variables/functions over creating redundant nodes.
• Keep one clear execution path per behavior branch.

3) Pin Wiring

• Connect exec pins before data pins to lock execution order.
• Inspect exact pin names via blueprint_query before connect_pins.
• Avoid ambiguous autowiring when multiple overload pins exist.