RealDocs

ACharacter::K2_OnMovementModeChanged

function Engine Blueprint Since 4.0
#include "GameFramework/Character.h"
Access: public Specifiers: UFUNCTIONBlueprintImplementableEventENGINE_API

Description

BlueprintImplementableEvent called when the movement mode changes, exposing both previous and new modes to Blueprint. This is the Blueprint-friendly counterpart to the C++ OnMovementModeChanged() virtual.

Caveats & Gotchas

  • • In Blueprint, this appears as the OnMovementModeChanged event node (the K2_ prefix is stripped by the DisplayName metadata). Do not search for 'K2_OnMovementModeChanged' in Blueprint.
  • • Unlike the C++ OnMovementModeChanged(), this event provides the NewMovementMode directly as a parameter, so Blueprint handlers don't need to query the movement component separately.

Signature

ENGINE_API void K2_OnMovementModeChanged(EMovementMode PrevMovementMode, EMovementMode NewMovementMode, uint8 PrevCustomMode, uint8 NewCustomMode);

Parameters

Name Type Description Default
PrevMovementMode EMovementMode Movement mode before the change. —
NewMovementMode EMovementMode Movement mode after the change. —
PrevCustomMode uint8 Previous custom mode index, relevant only if PrevMovementMode was Custom. —
NewCustomMode uint8 New custom mode index, relevant only if NewMovementMode is Custom. —

Return Type

void

Example

Toggle a swimming overlay UI in Blueprint text
// Blueprint override of OnMovementModeChanged event:
// Branch on NewMovementMode == Swimming → Show underwater UI widget.
// Branch on PrevMovementMode == Swimming → Hide underwater UI widget.

Version History

Introduced in: 4.0

Version Status Notes
5.6 stable —

Feedback

Was this helpful?

Suggest an edit

Select a field above to begin editing.