unreal.CharacterTrajectoryMovementTrait

class unreal.CharacterTrajectoryMovementTrait(outer: Object | None = None, name: Name | str = 'None')

Bases: MassMovementTrait

Overrides default movement to drive the entity along the generated trajectory. Extends UMassMovementTrait to provide FMassMovementParameters for AI systems.

Adds FCharacterTrajectoryMovementTag (matched by UCharacterTrajectoryToMovementProcessor) and FMassCustomMovementTag (disables UMassApplyMovementProcessor and USpringMovementApplyProcessor so that trajectory movement is the sole movement authority).

Requires UCharacterTrajectoryTrait — validated at template build time.

Execution flows with this trait:

  • With USpringMovementTrait: DesiredMovement -> UpdateSpring -> GenerateTrajectory -> MoveAlongTrajectory

  • Without spring: DesiredMovement -> GenerateTrajectory -> MoveAlongTrajectory

C++ Source:

  • Plugin: MassGameplay

  • Module: MassCharacterTrajectory

  • File: MassCharacterTrajectoryTrait.h

Editor Properties: (see get_editor_property/set_editor_property)

  • movement (MassMovementParameters): [Read-Write]

  • valid_target_config (ProcessorExecutionFlags): [Read-Write] Configures which configurations are targeted by this trait. Use it to have different configurations for client and server, for example.