API Reference

Component

Member	Kind	Purpose
`FindWarpComponent(Actor)`	Static, pure	The Crimson warping component on an actor, or null
`ResolveAndApply(Profile, Montage, Request, OutResult)`	Callable	Resolve and plant in one call; returns a handle
`ApplyResolved(Result, Montage, Scope, bForceDebugDraw)`	Callable	Plant an already-resolved point
`PreviewResolve(Profile, Montage, Request, OutResult)`	Callable	Resolve without planting or touching the world
`Release(Handle)`	Callable	Release one planted target; idempotent and safe to call late
`ReleaseAll()`	Callable	Release everything this component planted
`GetActiveLeaseCount()`	Pure	How many targets are currently leased
`GetEngineWarpingComponent()`	Pure	The engine `UMotionWarpingComponent`, creating it if absent
`GetLastResult()`	Pure	The last result resolved, for debug tooling

Blueprint library

Function	Kind	Purpose
`CrimsonResolveWarp(Avatar, Profile, Montage, Request, OutResult)`	Callable	The whole decision, without planting anything
`GetCrimsonWarpRadius(Actor)`	Pure	The horizontal collision radius used for standoff math
`WasCrimsonWarpPlanted(Result)`	Pure	Whether that outcome actually planted a target
`DescribeCrimsonWarpResult(Result)`	Pure	One line explaining what happened and why

Ability task

Member	Kind	Purpose
`CrimsonWarpToTarget(OwningAbility, Profile, Montage, Request)`	Factory	Creates the task. This is the Crimson Warp To Target node
`OnResolved`	Delegate	A target was planted. Carries the full result
`OnFailed`	Delegate	Nothing was planted. Carries the result and its outcome
`GetMutableWarpProfile()`	Pure, internal	This activation's profile copy. Used by the node's override pins

Profile settings

Property	Default	Purpose
`WarpTargetName`	`AttackTarget`	Must match the montage notify's warp target name exactly
`TargetSource`	`Provider`	Where to look for a target
`TargetPurposeTag`	None	Passed to the provider so one implementation can answer differently
`bRequireCommittedTarget`	false	Ignore soft targets and warp only toward a deliberate lock
`ScaleBand`	(0.30, 1.30)	Usable reach as a multiplier of authored travel. Only the upper bound clamps
`bUseExplicitReachOverride`	false	Replace the band with absolute centimetres
`MinReach` / `MaxReach`	0 / 500	The absolute band, when the override is on
`TooFarPolicy`	`ClampToMaxReach`	What to do when the target is out of reach
`ContactOffset`	0	Added on top of both capsule radii
`bUseTargetCapsuleRadius`	true	Include the target's own radius in the standoff
`ArrivalTolerance`	5	A gap below this counts as already arrived
`bClampToGeometry`	true	Sweep the path and stop at blocking geometry
`GeometryObjectTypes`	`WorldStatic`	What counts as blocking
`GeometrySkin`	2	Clearance kept from a blocking hit
`bFaceTarget`	true	Face the aim point as the warp runs
`MaxTurnSeconds`	0	Cap on how long the turn may take. Zero uses the notify's own settings
`Scope`	`UntilTaskEnds`	How long a planted target lives
`bAlwaysDrawDebug`	false	Draw this profile's resolves regardless of the console variable

Result

Field	Meaning
`Outcome`	Why the warp came out this way
`WarpTargetName`	The name this resolved for
`TargetActor`	What it resolved toward
`WarpPoint` / `WarpRotation`	Exactly what was handed to the engine
`PredictedStart`	Where the character is predicted to be when the window opens
`DistanceToTarget`	Horizontal distance from the predicted start to the target
`StopDistance`	Both capsule radii plus the contact offset
`GapToClose`	Distance actually needing travel, floored at zero
`NaturalTravel`	What the window travels unassisted
`AppliedTravel`	What the character will actually travel
`RequiredScale`	Pre-clamp ratio - what stock Motion Warping would have applied
`AppliedScale`	Post-clamp ratio. 1.0 means the animation plays as authored
`MinUsableReach` / `MaxUsableReach`	The reach band in centimetres
`MaxTurnSeconds`	The turn cap in force for this activation
`WindowStartTime` / `WindowEndTime`	The warp window's span
`WindowCount`	How many windows share this name
`FirstWindowScale`	The scale the first window alone will apply. Diagnostic
`bGeometryClamped`	Whether geometry shortened the path
`bServerCorrected`	Whether the server overruled a client's point

Enums

Enum	Values
`ECrimsonWarpOutcome`	`NotResolved`, `InRange`, `CompressedTooClose`, `ClampedTooFar`, `ClampedByGeometry`, `AlreadyInPlace`, `NoTarget`, `NoWarpWindow`, `NoRootMotion`, `NotRootMotionMontage`, `Blocked`
`ECrimsonWarpTooFarPolicy`	`ClampToMaxReach`, `PlayUnwarped`, `BlockActivation`, `ReportOnly`
`ECrimsonWarpTargetSource`	`Provider`, `Explicit`, `ProviderThenExplicit`, `ExplicitThenProvider`
`ECrimsonWarpScope`	`UntilTaskEnds`, `UntilMontageEnds`, `Manual`

Request

Field	Purpose
`ExplicitTarget`	Warp toward this actor instead of asking the provider
`ExplicitLocation`	Warp toward this world location, when no explicit actor is set
`bHasExplicitLocation`	Enables the location above
`MontagePositionAtResolve`	Montage position when resolving. Zero when resolving before playback

Per-activation tuning is not on the request

Values such as the turn cap and the reach band are overridden with the node's own pins, which write onto a per-activation copy of the profile. See How-To: Override Values Per Attack.

Target provider (CrimsonCommon)

These types live in CrimsonCommon, not in this plugin, so a targeting system can answer without depending on motion warping.

Member	Purpose
`ICrimsonWarpTargetProvider`	The interface to implement. Blueprint-implementable
`GetCrimsonWarpTarget(Query, OutResult)`	Return the current target, or false when there is none
`GetCrimsonWarpTargetPriority()`	Higher wins when an actor carries several providers
`FindBestWarpTargetProvider(Actor)`	Static. The highest-priority provider on an actor
`FindWarpTarget(Actor, Query, OutResult)`	Static. Find the best provider and query it in one call
`FCrimsonWarpTargetQuery`	`PurposeTag`, `InstigatorActor`, `MaxSearchDistance`
`FCrimsonWarpTargetResult`	`TargetActor`, `AimComponent`, `AimSocketName`, `AimWorldLocation`, `bIsCommitted`

Project settings

Setting	Default	Purpose
`bWarnOnMissingWarpTarget`	true	Warn when a warp window goes live with nothing planted
`MissingWarpTargetWarnInterval`	5	Seconds between repeats of that warning
`ServerAcceptTolerance`	100	How far a client's point may sit from the server's before it is clamped
`LeaseSlackSeconds`	1	Extra time on the target expiry watchdog
`bAllowDebugDrawing`	true	Project-wide gate for this plugin's debug drawing
`DebugDrawDuration`	2	How long debug drawing persists

Console

Command	Purpose
`Crimson.MotionWarping.Debug 1`	Draw the reach rings, the path taken, and the standoff ring
`Crimson.MotionWarping.DevTools`	Open the live Play In Editor inspector

Editor tooling

Create a profile from the Content Browser: right-click -> Crimson Plugins -> Motion Warping -> Warp Profile.

The plugin also ships an MCP toolset, so an AI assistant can inspect warping directly. It appears only when Crimson MCP is enabled in Project Settings -> Crimson -> Crimson MCP; see CrimsonCommon -> How-To: Manage MCP Toolsets.

Tool	Needs PIE	Purpose
`CheckWarpMontage`	No	Run the montage authoring checks against an asset, optionally against an expected warp target name
`ListWarpActors`	Yes	Every actor with a warping component, its lease count and its last outcome
`DescribeLastWarp`	Yes	The full derivation behind one actor's last warp
`ListWarpTargets`	Yes	Planted targets and live modifier states, flagging any window running with no target
`SetWarpDebugDraw`	No	Toggle the in-world reach rings

Gameplay tags

Shipped for the profile's TargetPurposeTag, so one provider can answer differently depending on what is asking. Providers may ignore them.

Tag	For
`CrimsonMotionWarping.Purpose.Melee`	Close-range attack looking for what it is about to strike
`CrimsonMotionWarping.Purpose.Ranged`	Repositioning for a ranged attack
`CrimsonMotionWarping.Purpose.Dash`	Movement closing or opening a gap
`CrimsonMotionWarping.Purpose.Finisher`	Execution that must line up with one specific victim
`CrimsonMotionWarping.Purpose.Traversal`	Vault or mantle, where the target comes from geometry