# BP\_MotionCharacter

This page describes the Motion Character Component that ships with Motion. The Motion Character provides a pre-configured character blueprint for your convenience. It includes all components that ship with motion and is ready-to-play.

It also processes all player input and provides the input events that are consumed by other components.

### Methods

#### Core

| Name                     | Description                                                                                                   |
| ------------------------ | ------------------------------------------------------------------------------------------------------------- |
| AdjustToCapsuleCenter    | Moves the meshes relative to the Capsule Center component. This is needed if the capsule half height changes. |
| GetSquaredPlayerVelocity | Returns the player velocity as squared float to get speed in units per second.                                |
| IsAboveCameraThreshold   | Returns if the camera movement is faster than the Movement Input Threshold.                                   |
| IsAboveMovementThreshold | Returns if the character is faster than the Movement Input Threshold.                                         |

#### Event Handler

| Name              | Description                                                     |
| ----------------- | --------------------------------------------------------------- |
| HandleOnEventTick | Checks if the player is moving and calls the appropriate event. |

***

### Variables

#### Configuration

| Name               | Description                                                                                                   |
| ------------------ | ------------------------------------------------------------------------------------------------------------- |
| CameraMinimumPitch | Used to define how far down the player is allowed to move the camera. Used to prevent clipping into the mesh. |
| UseDebugCamera     | If enabled, makes the primary camera visible and shows a third-person perspective while playing.              |

#### Event Dispatchers

| Name                       | Description                                       |
| -------------------------- | ------------------------------------------------- |
| OnMovementInput            | Triggered when a player input is registered.      |
| OnCameraInput              | Triggered when the camera moves.                  |
| OnCharacterMovementChanged | Triggered when the player moves.                  |
| OnMovementModeChanged      | Triggered when the players movement mode changes. |
| OnPlayerLanded             | Triggered when a player lands on a floor.         |
| OnJumpStopped              | Triggered after a jump was stopped.               |
| OnJumpJumped               | Triggered after a jump was executed.              |
| OnVelocityStop             | Triggered when the player stops moving.           |
| OnVelocityBegin            | Triggered when the player starts moving.          |

#### Component Data

| Name                          | Description                                                           |
| ----------------------------- | --------------------------------------------------------------------- |
| bEventOnVelocityStopTriggered | Is set to true, if the velocity stop event has been triggered already |