BP_CharacterCoreComponent

This page describes the CharacterCore Component that ships with Motion. The Character Core component provides commonly-used functions for all Curved Motion components and manages camera offsets and player speeds for the Motion Character.

We use this central approach for camera and speed changes to allow multiple sources of changes, where each component only has to manage their own adjustments, avoiding complex logic and computations.

Dependencies

• Requires the owning Blueprint to be BP_MotionCharacter.

• Said character must own: A camera, a character movement component, a capsule & a scene component acting as center actor for the dynamic resizing functionality.

Methods

Camera Location Offset

Name	Description
AddCameraLocationOffset	Adds a location of type Vector to the CameraVectors dictionary
AddHeadMovementCameraLocationOffset	Get the player's control rotation and add it to the location offset dictionary to prevent camera clipping into the mesh.
CalculateCameraLocation	Combines the vectors from the CameraVectors dictionary to a combined camera location offset. If a priority component is selected, it will instead use that component's value
FlushCameraLocationOffsets	Deletes all vectors from the currently dictionary.

Camera

Name	Description
AddCameraOffset	Adds a rotator for a provided component to the dictionary.
CalculateCameraOffset	Gets all values from the Camera Offsets Dictionary and combines them to a single Rotator.
FindCameraOffsetByIdentifier	Tries to find a camera offset by its curve identifier and returns it. Returns -1 if none was found.
FlushCameraOffsets	Deletes all rotators from the currently dictionary.
RemoveCameraOffset	Tries to find the provided component and removes it registered offset from the dictionary. If the component is the override one, delete the override.

Walk Speed

Name	Description
AddWalkSpeed	Adds a speed of type float to the WalkSpeed dictionary
CalculateWalkSpeed	Combines the speeds from the WalkSpeeds dictionary to combined walk speed. If a priority component is selected, it will instead use that component's value.
FlushWalkSpeeds	Deletes all rotators from the currently dictionary.

Components

Name	Description
GetCoreComponents	Get required components Character, Movement, Camera & Capsule and save their references

Core

Name	Description
GetGroundInfo	Finds the current floor and saves information about it
HandleOnEventTick	Core logic handler. Calculates camera offset and player speed from data provided by components.

Debug

Name	Description
PrintDebugInformation	Prints useful information on the screen. Helpful for debugging.

---

Variables

Configuration

Name	Description
GroundTraceDistance	Distance in units used, in addition to the capsule half height, to locate the nearest floor.
bShowDebugInformation	If enabled, will print useful information on the players screen.

Component Data

Name	Description
InitialCameraLocation	Location of the camera when first spawning the player. Used to add the Global Camera Location Offset.
CachedGroundInfo	Information about the last traced floor. Used for animation purposes.
CalculatedCameraLocationOffset	The current calculated camera location offset of the player in the current frame.
PriorityComponentForCameraOffsetOverride	If set, refers to which components speed value will be used. If this is set, all other values will be ignored.
PriorityComponentForCameraOverride	If set, refers to which curves rotation value will be used. If this is set, all other values will be ignored.
PriorityComponentForSpeedOverride	If set, refers to which components speed value will be used. If this is set, all other values will be ignored.
CameraVectors	Dictionary holding information about what components wants to add what location to the combined camera location.
WalkSpeeds	Dictionary holding information about what components wants to add what speed to the combined Max Walk Speed.
CameraOffsets	Dictionary holding information about what component wants to add what rotation to the combined offset.
GlobalCameraLocationOffset	The combined result of all registered camera location offsets. This vector will be set as the camera\'s position offset.
GlobalCameraOffset	The combined result of all registered camera offsets. This rotator will be set as the cameras local offset.

Default

Name	Description
CenterActor	Reference to the Center Actor.

Components

Name	Description
Capsule	Reference to the Character Capsule Collision.
CharacterMovement	Reference to the Character Movement Component.
Camera	Reference to the Character Blueprint Camera.
Character	Reference to the Character blueprint.