GreyFox Studio · Unreal Engine

ApexLock Pro

Combat Camera, Targeting & Visceral Execution System

  • Unreal Engine 5.7 — planned
  • Unreal Engine 5.8 — planned
  • C++
  • Blueprint
  • Editor Tools
  • Lock-On
  • Execution Camera
  • Level Sequence
Changelog Support Fab — coming soon
ApexLock Pro plugin cover
  • Status In Development
  • Current version 3.1.0
  • Supported engine versions Not validated yet
  • Planned engine versions Unreal Engine 5.7, Unreal Engine 5.8 — targeted for launch, not validated yet
  • Last updated 2026-10-24
  • Support support@greyfoxstudio.ca

Designed for souls-like, action RPG and melee-focused games.

Overview

ApexLock Pro drives the third-person camera through the whole fight: free exploration, locked-on combat and cinematic execution shots, all from data-driven presets and one shared, collision-safe framing solver.

Explore -> Lock On -> Switch Target -> Execute -> Back to Combat

Two components carry the system:

  • Apex Lock & Orbit Camera Director (UApexLockDirectorComponent) — free and combat camera, lock-on acquisition, target switching and lock retention;
  • Apex Visceral Execution Camera Director (UApexExecutionDirectorComponent) — phase-based execution camera, procedural or authored in a Level Sequence.

In development

ApexLock Pro is in active development and validation for Unreal Engine 5.7 and 5.8. The features below describe the current code; documentation and a Fab release will follow.

Features

Free and combat camera

  • orbit camera with distance, height, shoulder offset, field of view, per-axis sensitivity and invert
  • auto-recenter behind the character
  • wall compression and release with a hold delay, so the camera does not pump against walls
  • movement coordination modes: Strafe, Free and Hybrid (free sprint, strafe walk)

Multi-socket lock-on

  • acquisition inside a configurable range and view cone
  • candidate scoring by distance, screen centre, threat and visibility
  • visibility traced against several sockets per target — head, chest, base and weak point — and a blended focal point
  • target switching with stick or mouse, with cooldown and re-arm threshold
  • grace period with trajectory prediction when a target briefly breaks line of sight
  • automatic switch when the current target dies
  • pull-back framing for giant bosses
  • targets are indexed in a world subsystem spatial grid, so lock queries stay cheap in crowded arenas
  • any actor becomes targetable through the IApexLockTargetInterface

Visceral execution camera

  • five phases: Opening, Wind-Up, Impact, Aftermath and Recovery
  • three control modes: Procedural, Artist Sequence (curves or a Level Sequence) and Hybrid
  • camera-targeted Level Sequence evaluation: the execution camera is resolved by binding tag or by the Camera Cut track, with transform and field-of-view tracks evaluated
  • candidate camera angles with a five-step collision fallback, so a shot against a wall still finds a clear view
  • camera shake on impact
  • Motion Warping target written for the execution and restored afterwards
  • clean abort: the camera restores the gameplay viewport when an execution is interrupted
  • nearby-threat event raised during an execution
  • post-execution lock policies decide what the camera locks onto next
  • server-validated execution start with replicated state and phase sync

Collision-safe framing solver

  • one solver shared by the lock-on and execution cameras
  • per-frame collision trace budget, with traces reserved for the final safety sweep
  • sweep between frames so the camera never tunnels through geometry
  • screen-space safe margins keep both the player and the target in frame

Editor tools

  • Setup Wizard & Visceral Studio window: guided setup, preset library, guided objectives and an execution phase editor with timeline
  • execution preview directly in the editor viewport — play, pause and scrub, with the editor camera restored afterwards
  • diagnostics that detect common setup problems, most with a safe automatic fix
  • procedural demo arena generator built from engine basic shapes

Blueprint API

  • lock-on events: target acquired, switched, lost and lock state changed
  • execution events: started, phase changed, fallback activated, interrupted, completed and nearby threat detected
  • callable functions to toggle, force, clear and switch locks, start executions from a Data Asset, a profile id or contextual gameplay tags, advance phases, pause, change play rate or abort
  • Enhanced Input lock toggle bound from configuration

Camera preset library

Fifteen presets in four families. Each preset lives in a Data Asset (UApexLockProfileDataAsset, UApexExecutionProfileDataAsset) and can be duplicated into a new asset without overwriting the original. The diagrams are top-down sketches of the default framing: camera, player, target and field of view.

Exploration

Balanced Exploration

350 cm

All-round free camera that balances character visibility with a clear read of the environment.

Distance
350 cm
Height
+55 cm height offset, +35 cm shoulder offset
FOV
90°
Response
Camera follow speed 10.0; gentle auto-recenter while moving unlocked
Control
Free directional movement (character orients to movement); full manual orbit

Best for: General traversal outdoors and in standard dungeons, with a smooth transition into combat.

Exploration

Close Over-the-Shoulder Exploration

235 cm

Immersive over-the-shoulder framing for dense interiors and narrative exploration.

Distance
235 cm
Height
+42 cm height offset, +48 cm shoulder offset
FOV
84°
Response
Camera follow speed 12.5; wall reactivity 1.35x (faster compression against walls)
Control
Manual control takes priority: auto-recenter is off; free directional movement

Best for: Corridors, crypts, detailed villages and stealth sequences.

Exploration

Wide Panoramic Exploration

475 cm

Pulled-back, raised framing that maximizes terrain readability and spotting threats at a distance.

Distance
475 cm
Height
+80 cm height offset, +20 cm shoulder offset
FOV
98°
Response
Very soft camera follow (8.0); wall reactivity 0.9x
Control
Free directional movement; gentle auto-recenter while moving unlocked

Best for: Open plains, colossal arenas, platforming areas and tactical scouting.

Combat & Lock-On

Precise Duel (1v1)

325 cm

Tight lock-on framing built to read attack wind-ups and parries in one-on-one fights.

Distance
325 cm
Height
+55 cm height offset, -12° combat pitch (default)
FOV
90°
Response
Fast tracking (12.0); deliberate target switching (stick threshold 0.60)
Control
Strafe locked to the target (StrafeLockedToTarget); max lock range 2,500 cm

Best for: Duels against knights, hunters or standard-size humanoid elites.

Combat & Lock-On

Group Combat

435 cm

Pulls back and widens the view to keep enemies circling the player visible.

Distance
435 cm; the arm is extended 1.25x automatically when 3+ enemies are nearby
Height
+75 cm height offset
FOV
95°
Response
Wide 72° acquisition cone; quick switching between targets (stick threshold 0.45); auto-switch when the target dies
Control
Hybrid: strafe while walking, free movement when sprinting (above 520 cm/s by default); max lock range 2,900 cm

Best for: Fights against 3 or more enemies, ambushes and hordes.

Combat & Lock-On

Humanoid Boss

370 cm

Tuned for agile bosses that chain fast dashes, jumps and moves behind pillars.

Distance
370 cm
Height
+62 cm height offset; focal point blends the head, chest and base sockets
FOV
92°
Response
Very fast dash/teleport catch-up (24.0); 1.15 s line-of-sight tolerance behind pillars; 15 cm anti-jitter deadzone
Control
Strafe locked to the target; tracking 11.5; max lock range 3,200 cm

Best for: Fast humanoid bosses in arenas with pillars.

Combat & Lock-On

Giant Boss

520 cm

Automatically multiplies camera pullback by 1.65x and blends head, chest and base sockets so the giant stays readable.

Distance
520 cm base, up to 858 cm with the 1.65x giant pullback
Height
+95 cm height offset; strict pitch clamp [-50°, +58°]
FOV
96°
Response
Head/chest/base weighting adjusts with distance and height difference to avoid sudden vertical snaps
Control
Pitch clamp keeps the view stable while fighting beneath the boss; max lock range 4,500 cm

Best for: Dragons, golems and colossi where the player fights under the boss's legs.

Combat & Lock-On

Narrow Interior

235 cm

Immediate wall compression without harsh bounce-back, plus filtering of small set-dressing props.

Distance
235 cm
Height
+42 cm height offset
FOV
92°
Response
Wall reactivity 1.45x; 0.30 s hold before the camera eases back out
Control
Steady distance when strafing along a wall, without pumping in and out

Best for: Corridors, stairwells, sewers and narrow bridges.

Visceral Executions

Front Riposte

260 cm

Five-phase visceral sequence: opening framing, wind-up, 74° impact punch, aftermath and handover.

Distance
260 cm (Opening) -> 215 cm (Wind-Up) -> 165 cm (Impact) -> 250 cm (Aftermath) -> 320 cm (Recovery)
Height
Weighted anchors: 45% attacker / 45% victim at Opening; 60% weapon + contact point at Impact
FOV
88° -> 82° -> 74° at Impact -> 86° -> 90°
Response
Hybrid mode; 0.20 s entry / 0.32 s exit; collision solver scores 5 candidate angles with a 5-step fallback sequence
Control
Additive look correction during Recovery (±15° yaw / ±8° pitch); auto-acquires the nearest threat afterward

Best for: Frontal critical after a parry or guard break.

Visceral Executions

Stealth Backstab

110 cm

Tight close-up over the left shoulder (-35°) that highlights the weapon and the surprise.

Distance
Phase distances x0.82, then x0.72 close-up scale (about 0.59x overall), clamped to a 110 cm minimum
Height
Weapon anchor weight raised to 0.35
FOV
82° at Wind-Up -> 74° at Impact
Response
Fast transitions: 0.16 s entry / 0.28 s exit to keep the stealth flow going
Control
AcquireNearestThreat exit policy to chain into a nearby sentry

Best for: Critical attack from behind or a stealth takedown.

Visceral Executions

Heavy Finisher

260 cm

Broad, dramatic staging for colossal weapons and end-of-fight finishing blows.

Distance
260 cm -> 215 cm -> 165 cm at Impact -> 250 cm -> 320 cm
Height
Default five-phase pitch curve; longer Aftermath (0.65 s) to follow the fall
FOV
88° -> 82° -> 68° at Impact -> 86° -> 90°
Response
bExpandFramingForNearbyThreats: +85 cm per nearby extra threat, capped at 160 cm
Control
Wide entry (0.28 s) and measured exit (0.48 s); auto-acquires the nearest threat afterward

Best for: Giant hammers, greatswords or finishing an elite boss (about 2.05 s total).

Visceral Executions

Giant Weak-Point Critical

272 cm

Pulls the camera far back and anchors on the 'weakpoint_core' socket to keep the massive creature in frame.

Distance
All phase distances x1.65 (429 -> 355 -> 272 cm at Impact -> 413 -> 528 cm), allowed range 240-880 cm
Height
Anchored on the 'weakpoint_core' socket (contact weight 0.40); 18% safe screen margins
FOV
88° -> 82° -> 74° at Impact -> 86° -> 90°; no roll (0°) to preserve the monumental scale
Response
Screen-space check keeps the attacker visible; final collision sweep via FApexSharedFramingSolver::ValidateAndSecureFinalCameraDisplacement
Control
Auto-acquires the nearest threat afterward (default exit policy)

Best for: Visceral strike on the head or heart of a downed giant boss.

Visceral Executions

Subtle Gameplay-Style Execution

295 cm

Follows the execution with a very light orbit (+18°), with no cinematic cut and no loss of spatial bearings.

Distance
295 cm in every phase
Height
-11° pitch in every phase
FOV
86° constant
Response
Procedural mode; 0° roll; shake reduced to 0.35x; symmetric 0.25 s entry/exit blend
Control
Additive player look correction during the exit (AdditiveCorrection)

Best for: Quick executions in the middle of a dense melee where the player needs to keep their bearings.

Comfort

Comfort: Reduced Motion

340 cm · reduced motion

Cuts camera travel to 40%, removes horizon roll, reduces shake by 85% and blocks sudden camera cuts.

Distance
Keeps the active profile's distances; camera travel scaled to 40% (MotionReductionScale = 0.40)
Height
Vertical travel is scaled by the same 0.40 factor
FOV
FOV effects reduced to 25% (FOVEffectMultiplier = 0.25)
Response
ShakeIntensityMultiplier = 0.15, RollEffectMultiplier = 0.0; bDisableSuddenCameraCuts caps camera interpolation speed at 8.0
Control
No abrupt camera snaps during executions

Best for: Players prone to motion sickness or who want a very stable camera. Use alone or on top of any execution preset.

Comfort

Comfort: Execution Camera Off

340 cm · reduced motion

Runs Motion Warping, phases and impact events as usual while keeping the regular gameplay camera 100% of the time.

Distance
Unchanged (gameplay camera)
Height
Unchanged (gameplay camera)
FOV
Unchanged (no FOV change)
Response
bDisableExecutionCameraTakeover = true and bKeepGameplayCameraWithoutTakeover = true: the camera takeover is skipped
Control
The player keeps full control of their usual camera while the execution animation plays

Best for: Players sensitive to motion sickness, or who prefer to turn off cinematic execution cameras.

Compare two presets

Setting

Guided objectives

Plain-language goals instead of raw numbers: pick what you want the camera to do, and ApexLock Pro changes the matching settings. The tables show the exact settings and their default and adjusted values.

See More of the Fight4 settings

The player feels too close to the action or gets caught off guard by off-screen enemies.

SettingBeforeAfterWhy
SimpleGameplayCamera.DistanceCm350 cm413 cm (+18%)Pulls the camera back to widen the visible area around the character (clamped to 150-800 cm).
SimpleGameplayCamera.DefaultFOV90°95° (+5°)Opens the field of view (clamped to 60-110°).
SimpleLockOn.AcquisitionConeHalfAngleDeg55°65° (+10°)Widens the lock-on acquisition cone (clamped to 20-85°).
SimpleExecutionSettings.ShotScale / bExpandFramingForNearbyThreatsMedium / trueWide (1.25x) / trueWidens execution shots and keeps the automatic pullback active when other enemies are nearby.

Intent: SeeMoreOfTheBattle

Bring the Camera Closer3 settings

The designer wants more visceral, intimate and punchy framing for duels and executions.

SettingBeforeAfterWhy
SimpleGameplayCamera.DistanceCm350 cm287 cm (-18%)Moves the camera closer to the character (clamped to 140-700 cm).
SimpleGameplayCamera.LateralShoulderOffsetCm35 cm45 cm (+10 cm)Shifts the framing further over the shoulder.
SimpleExecutionSettings.ShotScaleMediumCloseUp (0.72x)Enables close-up execution framing (bEnableCloseUpFraming, CloseUpDistanceScale = 0.72).

Intent: BringCameraCloser

Track the Target Faster2 settings

Fast or teleporting enemies briefly slip out of the center of the screen.

SettingBeforeAfterWhy
SimpleLockOn.TrackingResponsiveness9.512.8 (+35%)Speeds up continuous rotation toward the locked target (clamped to 3-25).
StabilityConfig.FastDashCatchupSpeed18.022.5 (+25%)Speeds up catch-up when enemies dash or teleport (clamped to 8-40).

Intent: TrackTargetFaster

Reduce Abrupt Movements4 settings

The camera feels too twitchy during attack animations, near walls or on impacts.

SettingBeforeAfterWhy
SimpleLockOn.TrackingResponsiveness9.56.8 (-28%, minimum 4.5)Softens lock-on tracking.
ObstacleConfig.WallReleaseHoldDelay0.22 s0.35 sHolds the camera a little longer after leaving a wall to avoid pumping in and out.
StabilityConfig.AnimationJitterDeadzoneCm12.0 cm18.0 cmFilters out micro-oscillations of bones and sockets during animations.
AccessibilitySettings.MotionReductionScale / ShakeIntensityMultiplier / RollEffectMultiplier / bDisableSuddenCameraCuts1.0 / 1.0 / 1.0 / false0.55 / 0.25 / 0.0 / trueReduces execution camera travel to 55%, cuts impact shake to 25%, removes roll and blocks sudden cuts.

Intent: ReduceAbruptMovements

Keep More Control During Executions4 settings

The player doesn't want to lose control of the camera during and after an execution.

SettingBeforeAfterWhy
StabilityConfig.ManualInputOverrideWeight0.350.60Gives the player's stick more influence over the lock-on camera.
SimpleExecutionSettings.PlayerRecoveryControlAdditiveCorrection (default)AdditiveCorrectionGuarantees the player can adjust the view (±15° yaw / ±8° pitch) during the Recovery phase.
SimpleExecutionSettings.ExitDurationSec0.35 s0.25 sHands control back sooner.
ExecutionProfile.HybridProceduralWeight0.450.65On an Execution Profile data asset, gives the procedural camera more weight in Hybrid mode.

Intent: KeepMoreControlDuringExecution

Guided workflows

Step-by-step setup paths from the Setup Wizard & Visceral Studio window.

Set up a player character in 2 minutes2 min

For: Gameplay Designer / Blueprint Integrator

Steps
  1. In Unreal Editor, open Window > ApexLock Pro — Setup Wizard & Visceral Studio.
  2. Select your player character in the level and, in the Setup Wizard (8 Steps) & Diagnostics tab, click Use Selected Outliner Actor, then Re-run Full Diagnostic.
  3. If the camera, SpringArm, UApexLockDirectorComponent or UApexExecutionDirectorComponent is missing, click the diagnostic's safe fix button to create and attach the missing components (undoable).
  4. In the Visual Library of 15 Presets tab, find the Combat_PreciseDuel card (1v1 duel) and click Apply to Matching Category (Undo).
Check
  • The status banner reports the configuration as 100% valid and no Error-level diagnostic remains.
  • The wizard's Step 2 & 3 line shows at least one camera and one SpringArm found on the character.
Set up a lockable humanoid enemy2 min

For: Level Designer / Combat Designer

Steps
  1. Select the enemy in the level or open its Blueprint.
  2. Add the Apex Target Socket & Role Configurator component (UApexTargetSocketConfigComponent). For a level instance you can also select the enemy, click Set Selected Actor as Target (Step 6) in the Setup Wizard, then Step 8: Apply Full Configuration (Undo Transaction).
  3. Check the socket names in SocketConfig (defaults: head, spine_03, pelvis) and keep TargetCombatRole = HumanoidDuel (the default).
  4. Register the enemy as a lock-on target at runtime: in its Event Graph, BeginPlay > Get ApexLockSubsystem > RegisterTarget (Self).
  5. Click ValidateTargetSockets in the component's Details panel to list missing sockets, or call Apex: Validate & Draw Target Sockets to draw a sphere per socket (green = found, red = missing, fallback height used).
Check
  • Apex: Validate & Draw Target Sockets returns true and draws three green spheres (Head, Chest, Base) on the skeleton.
  • Apex: Toggle Lock-On locks onto the enemy when it is in front of the player (default acquisition cone: 55° half-angle) and within lock range.
Set up a giant boss (colossus or dragon)3 min

For: Combat Designer / Boss Designer

Steps
  1. Add the Apex Target Socket & Role Configurator to the boss and set TargetCombatRole = MassBossColossus.
  2. Set HeadSocketName, ChestSocketName and BaseSocketName (and optionally WeakPointSocketName) to bones that exist on the boss skeleton, for example head, spine_03 and pelvis.
  3. On the player, apply the Combat_GiantColossus preset: click Apply to Matching Category (Undo) on its card in the Studio, or set PresetType on a UApexLockProfileDataAsset, click ApplySelectedPresetWithUndo and assign the asset to ActiveLockProfileAsset (or call Apex: Apply Camera & Lock-On Profile Asset).
  4. Lock on and walk under the boss. The preset sets GiantBossPullbackScale = 1.65, GiantHeightThreshold = 300 cm and a pitch clamp of [-50°, +58°]; up close and underneath, the focal point blends toward the Base socket.
Check
  • Camera pitch stays within [-50°, +58°] while the player passes under the boss.
  • The focal point moves down toward the Base socket as the player gets close and below the boss.
Set up a 5-phase visceral execution4 min

For: Animator / Cinematic Director / Combat Designer

Steps
  1. In the Content Browser, create a Data Asset of class ApexExecutionProfileDataAsset (right-click > Miscellaneous > Data Asset).
  2. Set PresetType to a starting preset (Execution_FrontRiposte, Execution_StealthBackstab, Execution_HeavyFinisher, Execution_GiantWeakPoint or Execution_SubtleGameplayKeep) and click ApplySelectedPresetWithUndo.
  3. For an animated camera, set ControlMode to ArtistSequence or Hybrid, then set AnimationSourceType to ParametricCurves (assign TranslationCurve, RotationCurve and FOVCurve) or LevelSequenceAsset (assign SequenceAsset; the camera binding must match SequenceCameraBindingTag, ExecutionCamera by default).
  4. When the execution triggers, call Apex: Start Visceral Execution From Data Asset (Attacker, Victim, Data Asset, optional montage). Optionally call Apex: Notify Execution Phase Change from an Anim Notify to sync phases with the animation.
Check
  • The camera goes through the 5 phases (Opening, WindUp, Impact, Aftermath, Recovery), each with its own distance, yaw, pitch, FOV and framing anchor weights.
  • Near a wall, the final camera position is swept against collision and kept in front of blocking geometry (ValidateAndSecureFinalCameraDisplacement).
  • Apex: Interrupt / Abort Execution Camera restores the original camera FOV and SpringArm settings.
Preview and compare presets without launching the game1 min

For: Art Director / Camera Designer

Steps
  1. Select your character in the level, or click Generate / Regenerate Playable Demo Arena in the 5-Phase Editor, Timeline & Demo Arena tab to get a ready-made test scene.
  2. In the Visual Library of 15 Presets tab, click Preview in Viewport on a preset card: the editor viewport camera shows that preset's framing and the status banner shows its FOV.
  3. To compare, click Preview in Viewport on another card and switch back and forth (presets are previewed one at a time).
  4. In the 5-Phase Editor, Timeline & Demo Arena tab, pick a phase (Opening to Recovery), scrub the normalized time slider or click Play Continuously (5 Phases); adjust Distance, Yaw Offset and Target FOV for the selected phase, then click Save This Edited Profile as DataAsset to keep the result.
  5. Click Stop & Restore Editor Camera to return the viewport camera to its original position.
Check
  • Editor preview and runtime use the same shared solver (FApexSharedFramingSolver): for the same inputs, the preview pose matches the runtime pose.
  • After Stop & Restore Editor Camera the viewport camera is back where it was; if a preview pose is rejected by the safety checks, it is not applied and the viewport camera is restored.
Set up player comfort and accessibility options2 min

For: UI / UX Designer / Gameplay Programmer

Steps
  1. Bind your accessibility menu to the AccessibilitySettings of UApexExecutionDirectorComponent (MotionReductionScale, ShakeIntensityMultiplier, FOVEffectMultiplier, RollEffectMultiplier, bDisableSuddenCameraCuts, bDisableExecutionCameraTakeover). If DefaultProfileDataAsset is set, BeginPlay copies its ComfortSettings into AccessibilitySettings, so apply player choices after BeginPlay.
  2. For a one-click setting, call Apex: Apply Preset By Category To Actor with Comfort_ReducedMotion or Comfort_DisableExecutionKeepGameplay, or call ApplyComfortPresetOverlayWithUndo on an ApexExecutionProfileDataAsset.
  3. Check that with Comfort_DisableExecutionKeepGameplay the execution still runs while the gameplay camera stays in control.
Check
  • Comfort_ReducedMotion sets RollEffectMultiplier to 0, ShakeIntensityMultiplier to 0.15, FOVEffectMultiplier to 0.25 and MotionReductionScale to 0.40, and disables sudden camera cuts.
  • Comfort_DisableExecutionKeepGameplay sets bDisableExecutionCameraTakeover: the execution runs without taking over the camera, and other camera settings (such as lock-on distance) are left untouched.
Diagnose and fix a camera blocked by scenery2 min

For: Level Designer / QA Tester

Steps
  1. Enable bDrawExecutionDebugOverlay on UApexExecutionDirectorComponent. During an execution (non-shipping builds) it draws the focal point, the final camera position with its probe sphere, each candidate angle with its score (green = selected) and the camera's trajectory trail.
  2. If small props make the lock-on camera jitter, raise IgnoreSmallObstacleMaxBoundsRadius in the ObstacleConfig of UApexLockDirectorComponent (default 42 cm; the Combat_NarrowIndoor preset uses 55 cm). For pillars and foliage during executions, keep bEnableFoliageAndPillarDither enabled on the execution profile (on by default).
  3. Tune the execution profile's MaxCollisionTracesPerFrame (default 12 traces per frame), ReservedFinalSafetyTraces (default 3) and CollisionProbeSphereRadius (default 15 cm).
Check
  • ValidateAndSecureFinalCameraDisplacement sweeps from the last safe camera position to the new one, so the camera stops in front of walls even after smoothing.
  • When the trace budget runs out, the solver keeps the last verified camera position or aborts the camera takeover (bShouldAbortCameraTakeover) instead of using an unverified pose; the default FallbackSequence ends by returning to the gameplay camera (AbortToStandardGameplayCamera).

Diagnostics and safe fixes

The diagnostic pass analyses the selected actor and reports what blocks the camera from working. Fixes marked safe are applied with undo support.

Safe auto-fix

Camera, SpringArm or Apex director components missing

The selected character has no UCameraComponent, USpringArmComponent, UApexLockDirectorComponent or UApexExecutionDirectorComponent (any one missing triggers this Error).

Affects
Player character (AActor / APawn / ACharacter)
Action
Use the automatic fix button to create and attach the missing components (undoable).
Auto-fix
Creates only what is missing: a root component if the actor has none, a SpringArm (TargetArmLength 350 cm, bUsePawnControlRotation = true), a Camera attached to the SpringArm, UApexLockDirectorComponent and UApexExecutionDirectorComponent. Existing components are kept. From the Studio, the fix runs inside an undoable transaction.

MissingCameraOrSpringArm

Safe auto-fix

No targets registered in the lock-on subsystem

UApexLockSubsystem has no registered targets in the current level (Warning).

Affects
UApexLockSubsystem / enemy actors
Action
Add UApexTargetSocketConfigComponent to your enemies and register them with RegisterTarget (for example on BeginPlay).
Auto-fix
Registers the enemy selected as the Step 6 target in the Studio with UApexLockSubsystem. If no target actor is selected, nothing is registered and the fix reports failure.

NoTargetsRegisteredInSubsystem

Manual fix

Enhanced Input action references not set

ToggleLockInputAction or SwitchTargetInputAction is empty on UApexLockDirectorComponent (Info).

Affects
UApexLockDirectorComponent
Action
Assign your UInputAction assets in the component's 0_InputReferences category, or call Apex: Toggle Lock-On directly from your Event Graph.

UnassignedInputActionReference

Safe auto-fix

Incomplete execution camera profile or inverted bounds

On the DefaultFallbackProfile of UApexExecutionDirectorComponent, MinDistanceCm is greater than or equal to MaxDistanceCm, the phase list is empty, or FallbackSequence is empty (Error).

Affects
UApexExecutionDirectorComponent (DefaultFallbackProfile)
Action
Use the automatic fix button to restore valid bounds and phases.
Auto-fix
Resets the distance bounds to 110–520 cm only if they are inverted, restores the 5 default phases only if the list is empty, and restores the default FallbackSequence only if it is empty. Other values are left unchanged.

IncompleteCameraProfile

Safe auto-fix

Animated mode with no Level Sequence assigned

ControlMode is ArtistSequence or Hybrid and AnimationSourceType is LevelSequenceAsset, but SequenceAsset is empty (Warning).

Affects
UApexExecutionDirectorComponent (DefaultFallbackProfile)
Action
Assign a ULevelSequence to SequenceAsset, or use the automatic fix to switch the source to ParametricCurves.
Auto-fix
Switches AnimationSourceType to ParametricCurves on DefaultFallbackProfile. ControlMode is not changed and nothing is deleted.

MissingAnimationOrSequenceSource

Automated tests

The plugin ships Unreal automation test suites (ApexLockPro.*), runnable from the Session Frontend or headless.

20 of 20 shown

#1FApexAutomaticSpatialCellMigrationTest

ApexLockPro.Subsystem.AutomaticSpatialCellMigrationAndComplexity

Registers a target in UApexLockSubsystem, moves it across several 1000 cm cells with SetActorLocation, and checks that one Tick migrates it to the right cell without a manual update, prunes the old empty cell, finds it with a radius query at its new position, and removes it from every cell once the actor is destroyed.

A1M5M6

#2FApexScoringCooldownAndStickRearmTest

ApexLockPro.LockOn.ScoringCooldownAndStickRearm

With three enemies (center, right, left), checks that the center enemy is acquired first, a right stick flick switches to the right enemy, a second flick is blocked while the stick has not returned to center, and that after returning the stick to center (at or below StickRearmThreshold) during the active cooldown, the next flick switches target again.

A6B5M5

#3FApexWorldSocketBlendingAndTargetConfigTest

ApexLockPro.LockOn.WorldSocketBlendingAndTargetConfig

Sets up a MassBossColossus target with UApexTargetSocketConfigComponent and checks that the world-space blended focal point moves down toward the Base socket when the player is close and underneath, and that ValidateTargetSockets returns an actionable fallback warning when the target has no SkeletalMesh.

A2A3A8B3

#4FApexCameraCaptureMoveAbortAndRestoreTest

ApexLockPro.Execution.CameraCaptureMoveAbortAndRestore

Starts an Execution_FrontRiposte execution and checks that the camera takeover is active, that the camera's world location and FOV actually change through the Impact phase, and that AbortExecution() returns the director to Inactive, releases the takeover and restores the original FOV, SpringArm TargetArmLength and SocketOffset.

C7C16C19M5

#5FApexObstacleCollisionAndFinalPoseSafetyTest

ApexLockPro.Execution.ObstacleCollisionAndFinalPoseSafety

Places a blocking box wall between the focal point and a desired camera position behind it, and checks that ValidateAndSecureFinalCameraDisplacement detects the obstruction and keeps the final camera position in front of the wall.

C9M2

#6FApexCurveLevelSequenceAndHybridModesTest

ApexLockPro.Execution.CurveLevelSequenceAndHybridModes

In ArtistSequence mode, checks that EvaluateAnimatedSourcePose succeeds with ParametricCurves (UCurveVector translation, UCurveFloat FOV evaluated to 71.5) and with a ULevelSequence source. Despite its name, the test does not exercise Hybrid mode.

C2M1

#7FApexAllFourPostLockPoliciesTest

ApexLockPro.Execution.AllFourPostLockPolicies

Runs and aborts an execution under each post-execution lock policy and checks the result: RestorePreviousTarget and AcquireNearestThreat end locked on the target, FreeCameraNoRecenter and RecenterBehindPlayer end unlocked.

C8M5

#8FApexHeadlessResourceCleanupTest

ApexLockPro.Execution.SingleEventEmissionAndHeadlessResourceCleanup

Starts an execution on an attacker with no camera (as on a dedicated server) and checks that it starts without a local camera takeover, writes the Motion Warping target, and removes that target on abort even though no camera was taken over.

C13C19M3

#9FApexFifteenPresetsAndGoalDrivenConfigTest

ApexLockPro.PresetsAndUX.FifteenPresetsGoalDrivenAndComfortOverlay

Checks that the preset library exposes 15 cards and the guided workflow list has 7 entries, that the SeeMoreOfTheBattle goal increases BaseDistanceCm and logs the changed settings, and that the Comfort_DisableExecutionKeepGameplay overlay disables camera takeover while keeping the execution logic.

U1U2U3U5C17

#10FApexReproducibleDemoArenaBuilderTest

ApexLockPro.DemoGenerator.ReproducibleArenaBuilderValidation

Builds the demo arena with UApexDemoArenaGenerator and checks that it succeeds and spawns a playable character, at least 3 group/corridor targets, a giant colossus target and at least 3 walls/pillars.

U6

#11FApexFinalTrajectoryAndPenetrationRevalidationTest

ApexLockPro.V3_1.Point5_TrajectorySafetyAndPenetrationRevalidation

Places a blocking wall between PreviousSafeCameraLocation and the desired camera location, and checks that ValidateAndSecureFinalCameraDisplacement detects it without exhausting the reserved safety traces and stops the camera in front of the wall; with a trace budget of 0, it reports the budget as exhausted and returns PreviousSafeCameraLocation.

V3.1-5C9M2

#12FApexLevelSequenceExplicitCameraBindingTest

ApexLockPro.V3_1.Point7_LevelSequenceExplicitCameraBinding

Builds a ULevelSequence with two bindings, DummyCharacterTrack (at -999, -999, -999) and ExecutionCamera, and checks that SequenceCameraBindingTag selects the ExecutionCamera track rather than the first binding, and that a tag with no matching binding returns false so the parametric fallback is used.

V3.1-6M1

#13FApexEditorPreviewBoundViewportLifecycleTest

ApexLockPro.V3_1.Point6_EditorPreviewBoundViewportLifecycle

Editor only: starts preview playback of Execution_HeavyFinisher and checks that it plays, that a tick advances progress with a final FOV between 40° and 120°, that pausing stops playback, and that StopEditorPreview clears the active preview state.

V3.1-3C22

#14FApexPresetCategoryIsolationAndDuplicationTest

ApexLockPro.V3_1.Point4_PresetCategoryIsolationAndDuplication

Applies presets by category with Apex_ApplyPresetByCategoryToActor and checks that Exploration_WidePanoramic sets the lock-on distance to 475 cm without replacing the Execution_HeavyFinisher profile, and that Comfort_ReducedMotion keeps that distance and sets RollEffectMultiplier to 0. In the editor, duplicating the same preset three times with one name creates _01 and _02 copies instead of overwriting.

V3.1-4V3.1-9U1

#15FApexWizardNoDuplicatesAndIdempotentArenaTest

ApexLockPro.V3_1.Point2And3_WizardNoDuplicatesAndIdempotentArena

Generates the demo arena twice and checks that the second run removes all previous tagged demo actors and that ClearGeneratedDemoArenaInWorld removes them all. Runs the Setup Wizard twice on a level actor and on a Blueprint (SCS/CDO) and checks that exactly one LockDirector, ExecutionDirector, SpringArm and Camera exist, and that the Blueprint templates receive the selected presets, input action, camera name and SpringArm length.

V3.1-2V3.1-7U6

#16FApexWizardPreserveExistingProfileValuesTest

ApexLockPro.V3_1.Point2_WizardPreserveExistingProfileValues

Editor only: runs the Setup Wizard with bPreserveExistingProfileValues enabled and checks that a custom DistanceCm is kept on both a level actor (612 cm) and a Blueprint component template (640 cm) instead of being overwritten by the selected preset.

V3.1-2

#17FApexLevelSequenceStrictFOVTrackVerificationTest

ApexLockPro.V3_1.Point7_LevelSequenceStrictFOVTrackVerification

Adds a non-FOV float track (CustomMaterialParam = 42) to the ExecutionCamera binding of a ULevelSequence and checks that the camera transform is evaluated while the FOV stays at 88°, i.e. the unrelated float track is not applied as FOV.

V3.1-6M1

#18FApexReservedFinalSafetyTracesBudgetTest

ApexLockPro.V3_1.Point5_ReservedFinalSafetyTracesAndRuntimePreviewEquivalence

With MaxCollisionTracesPerFrame = 6 and 3 reserved safety traces, checks that the shared solver stays within budget and fills candidate debug scores, that the runtime EvaluateExecutionPhaseFrame and EvaluateDynamicExecutionCameraStep return the same location, rotation and FOV as the shared solver, and (in the editor) that PreviewDynamicStepInViewport matches the runtime result.

V3.1-5V3.1-3C26M6

#19FApexChildBlueprintProtectionAndGlobalBudgetTest

ApexLockPro.V3_1.Point4And6_ChildBlueprintProtectionAndGlobalTraceBudget

Configures a parent Blueprint, then runs the Setup Wizard twice on a child Blueprint and checks that the parent's SCS nodes and values are unchanged, that the child creates no duplicate SCS nodes, that its overrides (through UInheritableComponentHandler) survive compilation, and that Undo/Redo works. Then checks that a dynamic camera step with a trace budget of 0 runs no traces, flags the budget-exhausted fallback and keeps the current verified camera location.

V3.1-2V3.1-4C26M2

#20FApexUnverifiedCandidatesPreviewAbortAndNearbyThreatEventTest

ApexLockPro.V3_1.Point1To4_UnverifiedCandidates_PreviewAbort_NearbyThreatEvent

Checks that, with only 3 traces, the obstructed candidate is VerifiedObstructed while the budget-starved candidates are Unverified with 0.0 scores and never win; that (in the editor) a preview with no trace budget sets bShouldAbortCameraTakeover, stops playback, records the abort reason and restores the viewport camera without applying the rejected pose, in both dynamic and static preview; and that OnNearbyThreatDetectedDuringExecution fires once per change in nearby threat count, not every frame.

V3.1-10V3.1-11V3.1-12C6C18

Requirements matrix

Every technical requirement of version 3.1.0, checked against the current source code.

How to read the status

Implemented — present and working in the code. Partial — present but incomplete; the note says what is missing. Not implemented — specified but not in the code yet. The matrix is updated as development continues.

72 of 72 shown

CodeRequirementStatus
A1A1. Dynamic 3D spatial grid subsystem (UApexLockSubsystem : UTickableWorldSubsystem)Inherits UTickableWorldSubsystem: each tick RefreshMovedTargetsAndPrune() re-buckets moved targets in round-robin batches of MaxTargetsCheckedPerTick, destroyed actors are removed through an OnDestroyed binding, and GetTargetsInRadius() only visits overlapping cells. Targets must be registered with RegisterTarget() (the setup wizard and demo generator do this for you). Each tick also snapshots all registry keys, so tick cost is O(N) plus the refreshed batch. Covered by FApexAutomaticSpatialCellMigrationTest.Implemented
A2A2. True world-space multi-socket blending (Head, Chest, Base) & no-code target componentComputeWorldBlendedFocalPoint() resolves the Head, Chest and Base sockets in world space (custom interface location, then skeletal mesh socket, then height-based fallback) and blends them by distance and altitude. Socket names and offsets come from the lock director's own SocketConfig. Covered by FApexWorldSocketBlendingAndTargetConfigTest.Note: Settings on UApexTargetSocketConfigComponent are ignored by lock-on: queries only check whether the actor class implements IApexLockTargetInterface, so per-target socket names, offsets and heights set on the component have no effect.Partial
A3A3. Auto-framing for colossi and giant bossesWhen the combat context is MassBossColossus, the spring arm length is multiplied by FramingConfig.MaxGiantArmLengthMultiplier. The context is detected at acquisition from IApexLockTargetInterface (GetTargetCombatRole or GetTargetVerticalSize >= GiantHeightThreshold).Note: Giant detection only works when the target's actor class implements IApexLockTargetInterface; UApexTargetSocketConfigComponent roles/heights are ignored and the claimed GetComponentsBoundingBox() height estimate does not exist. The context is evaluated only on acquisition, not after a directional target switch.Partial
A4A4. Anti-gimbal pitch clamp under giant bossesLock-on and free-camera pitch are clamped between FramingConfig.MinPitchClamp and FramingConfig.MaxPitchClamp, preventing flips at the zenith.Implemented
A5A5. Line-of-sight hysteresis memory & trajectory extrapolationWhen all socket traces are blocked, the lock enters GracePeriod and, if enabled, LastKnownFocalPoint is extrapolated with LastEstimatedTargetVelocity * DeltaTime until OutOfSightTimer reaches LoSHysteresisDuration.Implemented
A6A6. Directional target switching with re-arm when the stick returns to centerSwitchTargetByDirection() checks InputMagnitude <= StickRearmThreshold first and re-arms switching when the stick returns to center. The cooldown is not reset; it blocks weak inputs and is bypassed only by strong flicks (magnitude >= 0.85). Candidates must be visible and aligned with the stick direction. Covered by FApexScoringCooldownAndStickRearmTest.Implemented
A7A7. Enhanced Input integration & Blueprint function libraryUApexLockDirectorComponent exposes InjectManualCameraInput(FVector2D) and BindConfiguredEnhancedInputActions(). UApexBlueprintLibrary provides static nodes such as Apex_ToggleLockOn, Apex_SwitchLockTarget, Apex_ApplyLockProfileAsset, Apex_ApplyPresetByCategoryToActor, Apex_ApplyGuidedObjectiveToActor, Apex_StartExecutionFromPreset and Apex_AbortExecution.Note: BindConfiguredEnhancedInputActions() only binds ToggleLockInputAction; the switch-target, manual-look and finisher actions are stored but not bound, so they must be wired in Blueprint.Partial
A8A8. Native IApexLockTargetInterface AND no-code UApexTargetSocketConfigComponentIApexLockTargetInterface provides BlueprintNativeEvents with native _Implementation defaults, and UApexTargetSocketConfigComponent implements the same interface with editor-configurable fields.Note: The component route does not work in practice: lock-on, scoring and context queries only check whether the actor class implements the interface, so the component's settings are ignored. The listed fields bCanBeLockedOn, TargetWeightMultiplier, OverrideVerticalSizeCm and CombatRole do not exist (actual names above; there is no vertical-size override).Partial
A9A9. Real-time diagnostics, candidate score overlay & safe auto-fixApex_DiagnoseCharacterSetup() and Apex_ExecuteSafeDiagnosticFix() exist. With bShowDebugDiagnosticHUD, DrawDebugDiagnosticHUD() draws the current focal point and a line to it.Note: There is no per-candidate lock-on score overlay (distance, screen center, threat, visibility); the HUD only draws the focal point. No automation test covers the diagnostics.Partial
B1B1. Danger-aware contextual framing (exploration, duel, group, boss, indoor)DetectDynamicCombatContext() picks MassBossColossus (interface role or height), EnemyGroup (3+ registered targets within lock range) or HumanoidDuel at acquisition. The arm length is then scaled (boss multiplier, x1.25 for groups).Note: Only arm length changes per context; height and screen offset do not. The NarrowCorridor/indoor context is never detected (no lateral confinement check), and boss detection requires the interface on the actor class.Partial
B2B2. Robust wall handling, asymmetric compression/release and small-obstacle filteringA sphere sweep from the pivot ignores hits whose bounds radius is <= IgnoreSmallObstacleMaxBoundsRadius, compresses with WallCompressionInterpSpeed, and releases with WallReleaseInterpSpeed after WallReleaseHoldDelay (minimum arm length 75 cm).Implemented
B3B3. Stable targeting of large enemiesCombines world-space socket blending (weight shifts toward Chest and Base when the target is above the player), the giant arm-length multiplier and the anti-gimbal pitch clamp.Note: The giant pull-back only triggers when the target's actor class implements IApexLockTargetInterface (see A3); targets configured only through UApexTargetSocketConfigComponent are not treated as giants.Partial
B4B4. Keeping the target through brief visibility loss (pillars, columns)Traces to the three sockets (Head, Chest, Base); while all are blocked the lock stays in GracePeriod with velocity-based prediction for LoSHysteresisDuration. Obstacles smaller than IgnoreSmallObstacleMaxBoundsRadius do not count as blocking.Implemented
B5B5. Predictable target selection and switching with configurable weightsCandidate score = distance, screen-center angle, threat multiplier and visible-socket ratio, each weighted, plus a +0.15 bonus for the current target (hysteresis). The threat multiplier is read only from an interface on the actor class.Implemented
B6B6. Animation micro-movement filtering and differentiated dampingFocal-point changes smaller than AnimationJitterDeadzoneCm are ignored; DodgeFollowInterpSpeed is used while the player moves faster than 650 cm/s and FastDashCatchupSpeed when the target moves more than 280 cm in one frame (teleport/dash).Implemented
B7B7. Respecting player intent; pitch inversion applies to player input onlybInvertPitchInput (and bInvertYawInput) are applied only in InjectManualCameraInput() to the player's manual input, never to automatic tracking. During lock-on the manual offset is scaled by ManualInputOverrideWeight. Manual input must be injected every frame (see A7).Implemented
B8B8. Coordination between camera and character movementSets bOrientRotationToMovement and bUseControllerRotationYaw according to EApexMovementCoordinationMode while locked, and restores the saved flags in ClearLockOn().Implemented
B9B9. Accessible settings, Data Assets, 15 presets and contextual helpSettings are split into Simple/Essential and AdvancedDisplay tiers with explicit units (cm, deg, s); UApexLockProfileDataAsset and UApexExecutionProfileDataAsset hold presets; 15 presets and goal-driven objectives are available. Most labels and tooltips are written in French.Implemented
B10B10. Combat edge cases (teleport, slope, target death mid-combo, low ceiling)Sudden target jumps use FastDashCatchupSpeed, slope pitch is compensated with SlopePitchCompensationFactor, and when the locked target becomes invalid the director auto-acquires another target.Note: There is no dedicated low-ceiling handling (only the generic spring-arm sweep). Death is detected only when the actor is destroyed or CanBeLockedOn() returns false through an interface on the actor class. Auto-switch on death broadcasts OnTargetAcquired, not OnTargetSwitched.Partial
C1C1. Per-execution profiles, priority/tag selection and fallback profileSelectBestMatchingProfile() scans RegisteredProfiles, skips profiles whose RequiredContextTags, weapon tag or animation identifier do not match, and picks the highest score (PriorityScore, +50 for matching TargetMorphology, +100 for an exact animation match).Implemented
C2C2. Procedural, animated (UCurveVector curves AND ULevelSequence) and hybrid modes with a single camera writerFApexSharedFramingSolver::EvaluateAnimatedSourcePose() loads the ULevelSequence and evaluates the camera binding's UMovieScene3DTransformSection channels (translation X/Y/Z, rotation) and a FieldOfView UMovieSceneFloatSection at the current normalized progress, or samples TranslationCurve/RotationCurve/FOVCurve, in the execution reference frame. Hybrid blends with procedural framing by HybridProceduralWeight. UApexExecutionDirectorComponent is the only writer to the UCameraComponent. Covered by FApexCurveLevelSequenceAndHybridModesTest.Implemented
C3C3. Multi-anchor framing references with per-phase weightsComputeWeightedFocalPoint() resolves attacker, victim, weapon and contact-point sockets and weights them by the active phase's PhaseWeights.Note: Profile-level FramingAnchors are used only when the active phase's weights sum to zero, so preset anchor overrides (for example the GiantWeakPoint weak-point socket) have no effect with the default phases. A default-data typo also assigns the Aftermath weapon weight to the Impact phase.Partial
C4C4. On-screen composition, safe-margin projection and limitsAt runtime EnforceScreenSpaceSafeMarginsMathematically() projects attacker and victim into camera space (16:9 assumed) and, if either leaves SafeScreenMarginX/Y, pulls the camera back up to 1.45x within MaxDistanceCm after a collision-checked sweep. Yaw, pitch and roll limits and LocalCameraOffset are applied in the solver.Implemented
C5C5. Five execution phases, each with its own settingsGetActivePhaseConfig() returns the settings matching CurrentPhase (Opening, WindUp, Impact, Aftermath, Recovery); duration, distance, FOV, roll, interpolation speeds and shake are per phase.Note: A phase's IdealYawOffset is ignored whenever CandidateAngles is non-empty (the default), and IdealPitch only contributes 25%; this also makes the Simple PreferredSide setting ineffective. The Impact phase label mentions hit-stop, but hit-stop/time dilation is not implemented.Partial
C6C6. Smart placement and best-angle selection (CandidateAngles)Each CandidateAngles entry is scored by ObstacleClearanceWeight, FramingVisibilityWeight and TrajectoryStabilityWeight, minus a variety penalty from RecentChosenAngleIndices; verified-free candidates always rank above unverified ones, and CameraSwitchHysteresisScore plus MinAngleSwitchDelay keep the current angle.Implemented
C7C7. Non-destructive, safe entry (EntryBlendDuration) and exit (ExitBlendDuration) transitionsCamera, spring-arm and controller state is captured in SavedCameraState; entry and exit blends are collision-checked; the exit blends toward the live gameplay target (ComputeLiveHostGameplayCameraTarget) and stops driving the camera if another view target takes over.Note: When the view target was changed externally (or the comfort no-takeover flag changes mid-run), RestoreCameraStateToHost() skips restoring the camera's relative transform, FOV and bUsePawnControlRotation, leaving the camera altered.Partial
C8C8. Player control handover (3 modes) and lock continuity (4 policies)Implements IgnoreDuringTransition, ImmediateOverride and AdditiveCorrection exit modes, plus RestorePreviousTarget, AcquireNearestThreat, RecenterBehindPlayer and FreeCameraNoRecenter lock policies. Covered by FApexAllFourPostLockPoliciesTest.Implemented
C9C9. Predictive collision detection, initial clearance and post-smoothing final sweepCandidate sweeps plus ValidateAndSecureFinalCameraDisplacement() on the final smoothed position, with extraction on bStartPenetrating, all within MaxCollisionTracesPerFrame.Note: Nothing is predictive: PredictiveCollisionLookaheadTime is never read, so collisions are checked only for the current frame's pose.Partial
C10C10. Selective occlusion handling and material restoration (dither)ApplyOrUpdateOcclusionDither() and RestoreAllDitheredMaterials() exist and would record original scalar values in ActiveResources.ModifiedDitherRecords, but the only caller (ResolveCollisionWithOrderedFallbacks) is never invoked.Note: Dead code: the runtime path uses the shared solver, which has no dither step, so these settings have no effect.Not implemented
C11C11. Configurable fallback order (FallbackSequence) and zenith validationThe shared solver walks FallbackSequence in order (SideAngleSwap, ReverseSideAngle, DistancePullbackAndCompress, HighAngleZenithFallback, AbortToStandardGameplayCamera) and sweeps each pose, including the zenith pose, before accepting it. SideAngleSwap rotates the orbit by 90°.Implemented
C12C12. Sync with animations, PlayRate and Anim NotifiesBinds OnMontageEnded on the attacker's AnimInstance, scales phase time by the montage PlayRate, and exposes TriggerImpactEventFromNotify() and AdvanceToPhase().Note: OnMontageBlendingOut is not bound. A montage PlayRate of 0 is clamped to 0.1 rather than treated as a pause, and a paused montage reverts to the component's own play rate.Partial
C13C13. Motion Warping coordination and warp-target ownershipSynchronizeMotionWarpingTarget() saves any pre-existing warp target of the same name in ActiveResources, then writes the victim target every tick; RestoreOwnedMotionWarpingTarget() restores the saved transform or removes the target at cleanup.Note: There is no per-execution ownership ID (OwnerExecutionInstanceId/SavedWarpTargetState do not exist): a same-name target written by another system mid-execution is overwritten each tick and removed at cleanup, and restoration keeps only the transform (not avatar, bone or follow settings).Partial
C14C14. Uneven terrain adaptation (slopes, stairs, ledges)The shared solver measures the attacker/victim height difference, tilts pitch by half the slope angle and raises the camera by 25% of the height difference.Implemented
C15C15. Adapting to participant size (morphologies)TargetMorphology only adds a +50 bonus during profile selection (C1). StartContextualExecution() derives a morphology from interface height. The framing solver never scales distance or height by morphology or victim height.Note: No morphology-based scaling of distance or height exists in the runtime or preview solver.Not implemented
C16C16. Real FOV application, speed curves and controlled impact effectsEach tick with a local camera takeover, ActiveCamera->SetFieldOfView() applies the interpolated FOV, and ClientStartCameraShake fires on entering the Impact phase if ImpactCameraShakeClass is set. Hit-stop/time dilation is not implemented.Implemented
C17C17. Player comfort and accessibility options (dedicated, stackable presets)AccessibilitySettings feed the solver (motion amplitude, FOV effect, roll, shake, sudden-cut smoothing). Two comfort presets (Comfort_ReducedMotion, Comfort_DisableExecutionKeepGameplay) can be used alone or layered on any execution profile asset via ApplyComfortPresetOverlayWithUndo().Implemented
C18C18. Danger readability around the player (secondary threats in a crowd)The shared solver queries UApexLockSubsystem::GetTargetsInRadius() around the attacker and pulls the camera back by CrowdThreatPullbackDistanceCm per extra registered threat (capped at 160 cm).Implemented
C19C19. Clean interruption at any time and idempotent cleanupAbortExecution(), FinishExecution() and EndPlay() all go through CleanupExecutionResources(), which is safe to call repeatedly and also works without a local camera.Note: A single terminal event is not guaranteed: an abort with a local camera broadcasts OnExecutionInterrupted and then OnExecutionCameraCompleted when the exit blend ends, and calling AbortExecution() again during the blend restarts it and re-broadcasts OnExecutionInterrupted.Partial
C20C20. Orientation continuity and prevention of 180° flipsCandidate stability score falls with the yaw difference from the current camera rotation and is weighted by TrajectoryStabilityWeight; CameraSwitchHysteresisScore and MinAngleSwitchDelay prevent rapid flips.Implemented
C21C21. Controlled variety and anti-repetition angle historyThe last chosen angle indices are kept in RecentChosenAngleIndices (up to 5) and recent angles receive a variety penalty of 0.08 per recency step.Implemented
C22C22. Authoring tools, Slate studio and interactive preview using the shared solverUApexProfileEditorSubsystem previews profiles, data assets and built-in presets in the level editor viewport through FApexSharedFramingSolver (SolveExecutionPhaseFraming for static frames, EvaluateDynamicExecutionCameraStep for playback), with the SApexStudioMainPanel Slate UI.Note: Side-by-side A/B preset comparison does not exist (no CompareTwoPresetsInViewport). Static previews from the studio pass no victim actor.Partial
C23C23. Visual debugging tools (anchors, candidate angle scores, trace budget, fallbacks)DrawExecutionDebugOverlay() draws the focal anchor, the final camera probe sphere, each candidate with its total, clearance and visibility scores, and a trajectory trail.Note: The overlay does not show the trace budget used, the active fallback step or the stability score.Partial
C24C24. Simple, non-destructive integration with no required character classModular UActorComponent that finds the participant's UCameraComponent and USpringArmComponent automatically (first component of each class) on any pawn, or on a non-pawn actor in standalone.Implemented
C25C25. Blueprint/C++ events and extension points with a single terminal eventExposes six BlueprintAssignable delegates, broadcast even on a dedicated server or headless run without a local camera.Note: There is no terminal-event guard (bTerminalEventBroadcastedForCurrentRun does not exist); one run can emit both OnExecutionInterrupted and OnExecutionCameraCompleted (see C19).Partial
C26C26. Controlled performance, MaxCollisionTracesPerFrame budget and idle tickTickComponent returns immediately while ExecutionLifecycleState is Inactive, and the solver caps physics sweeps per frame at MaxCollisionTracesPerFrame, reserving ReservedFinalSafetyTraces for the final safety sweep.Implemented
C27C27. Multiplayer: server validation, late joiners, local victim and spectatorsRequestStartExecution() calls ServerRequestStartExecution (authority, attacker ownership and MaxServerValidationDistanceCm checks); ReplicatedExecutionState replicates the profile ID, phase and start time and OnRep_ReplicatedExecutionState() starts the execution on clients; ResolveLocalControllerForExecution() picks the attacker, local victim or spectator camera; MultiCastSynchronizePhase syncs phase changes.Note: Late-joiner catch-up compares the server's GetTimeSeconds() with the client's own (unsynchronized) clock, so elapsed time is unreliable; ActiveProfileId resolves only registered profiles, the default asset and some built-in preset IDs; the server path drops the sync montage; MultiCastNotifyExecutionEnded does not exist (end is replicated through state). No multiplayer test exists.Partial
C28C28. Automated validation suites (FAutomationTestBase) & CLI scriptApexLockProAutomationTests.cpp contains 20 FAutomationTestBase suites (not 10) that call real plugin code on actors with root components and blocking walls; Scripts/RunApexLockTests.bat builds the editor target and runs ApexLockPro.* tests. Pass results were not verified in this review, and the v3.1.0 test file needed compile fixes for UE 5.8.Implemented
M1M1. Complete the ULevelSequence source (loading, execution-frame evaluation, pause/PlayRate, Hybrid)Loads SequenceAsset, resolves the camera binding, evaluates UMovieScene3DTransformTrack and FieldOfView UMovieSceneFloatTrack channels at the frame matching normalized execution progress in the execution reference frame. Pause and PlayRate act on that progress (no sequence player is spawned). Hybrid applies collision correction, and the execution director is the single UCameraComponent writer.Implemented
M2M2. Secure the final camera displacement (post-smoothing, entry/exit, bStartPenetrating, budget)ValidateAndSecureFinalCameraDisplacement() sweeps from the safe anchor to the final smoothed position every frame (phases, entry blend and exit blend), extracts the camera on bStartPenetrating, re-validates the adjusted pose and respects MaxCollisionTracesPerFrame.Implemented
M3M3. Separate execution state from local camera takeover (idempotent cleanup)ExecutionLifecycleState, ActiveResources and bHasLocalCameraTakeover are separate. CleanupExecutionResources() always releases montage delegates, dither records, owned Motion Warping targets and transient sequence objects, even without a local camera, and returns lock-on arbitration on full cleanup.Note: The one-terminal-event-per-execution guarantee does not hold (see C19).Partial
M4M4. Complete networking, server validation, late joiners and spectatorsServerRequestStartExecution checks authority, ownership and distance; ReplicatedExecutionState propagates ActiveProfileId and ServerStartWorldTime to late joiners; ResolveLocalControllerForExecution() handles attacker, local victim and spectator.Note: Same gaps as C27: late-joiner timing uses unsynchronized local clocks and no multiplayer test exists.Partial
M5M5. Fix and complete the C++ automation tests and the CLI scriptTest actors get a USceneComponent root, collision tests use real blocking UBoxComponent walls, and cell migration is driven through Subsystem->Tick(). The file now holds 20 suites. Pass results were not verified in this review.Implemented
M6M6. Align the tools: shared runtime/preview solver and O(N) vs O(C+K) complexityRuntime and editor preview both call FApexSharedFramingSolver (SolveExecutionPhaseFraming and EvaluateDynamicExecutionCameraStep). The UApexLockSubsystem header documents maintenance cost separately from O(C+K) query cost.Note: The header's "amortized O(B) tick" claim is inaccurate (each tick snapshots all N registry keys), and no document listing the items that need PIE ships with the plugin.Partial
U1U1. Visual library of 15 presets (exploration, combat, executions, comfort)GetAllVisualPresetLibraryCards() returns 15 cards (title, short description, recommended situation, text framing sketch, effects on distance/height/FOV and reactivity/control, limits). The studio shows Preview, Duplicate and Apply buttons; Apply runs inside an FScopedTransaction. Card text is in French.Implemented
U2U2. 15 distinct, useful presets (3 exploration, 5 combat, 5 executions, 2 stackable comfort)EApexPresetProfileType defines the 15 presets; lock presets are applied by UApexLockProfileDataAsset::ApplySelectedPresetWithUndo() and execution presets built by BuildPresetExecutionProfile(); the two comfort presets can be layered on any execution profile with ApplyComfortPresetOverlayWithUndo(). Covered by FApexFifteenPresetsAndGoalDrivenConfigTest.Implemented
U3U3. Goal-driven settings (5 intents in plain language)PreviewGuidedObjectiveChanges() and ApplyGuidedObjectiveWithUndo() turn five intents (see more of the fight, bring the camera closer, track the target faster, reduce abrupt motion, keep more control during an execution) into fixed adjustments and return the before-to-after list of changed parameters. Apex_ApplyGuidedObjectiveToActor() applies them to a character's components.Implemented
U4U4. Concrete contextual help on essential settings (effect, when to raise/lower, range, comfort)Apex_GetAllContextualParameterHelp() returns structured help (what it does, effect when raised/lowered, interactions, how to reset), shown in the studio's goals and help tab; Simple-tier settings also carry ToolTip metadata.Note: Only 5 settings have structured help entries (DistanceCm, HeightOffsetCm, TrackingResponsiveness, ObstacleOcclusionToleranceSec, CinematicIntensity); most advanced settings have no tooltip, and the help text is in French.Partial
U5U5. 7 step-by-step guided workflows in the Unreal EditorApex_GetAllGuidedWorkflows() provides 7 workflows shown in the studio: (1) first working lock-on, (2) free camera tuning, (3) giant boss camera, (4) riposte setup, (5) backstab setup, (6) animated camera (curves or Level Sequence), (7) framing/collision troubleshooting. Workflow text and the quick-start doc are in French.Implemented
U6U6. One-click reproducible demo scene (UApexDemoArenaGenerator)GeneratePlayableDemoArenaInWorld() first clears previous demo actors, then spawns a demo character, a duel dummy, three group dummies, a giant dummy (capsule scaled 3.2x, about 5.6 m), two corridor walls, a pillar and a corridor dummy, all tagged ApexLockDemoArenaActor and registered with the subsystem. Covered by FApexReproducibleDemoArenaBuilderTest.Note: It is a code generator, not shipped content: the plugin includes no map or assets. There is no exploration zone and no floor; dummies are mesh-less characters (invisible, so socket names fall back), and their configurator roles are ignored by lock-on (see A8). The studio button generates into the editor world, and nothing re-registers the dummies in the PIE world's subsystem, so lock-on finds no targets in PIE.Partial
U7U7. Actionable diagnostics with automatic repair limited to safe operationsApex_DiagnoseCharacterSetup() reports issues with a plain-language explanation and recommended manual fix; Apex_ExecuteSafeDiagnosticFix() repairs missing camera/spring arm, unregistered targets, incomplete execution profile bounds and a missing animation source, and never edits the project's Input Mapping Contexts.Note: Only 5 of the 7 issue codes are ever detected: MissingTargetSocketOnMesh and NoClearFramingAngleAvailable are declared but never reported. Safe auto-fixes cover 4 codes, not 6.Partial
V3.1-1V3.1-1. Strict C++ syntax for TEXT(...) literals in ApexEditorPanels.cpp and all sourcesThe raw line breaks inside TEXT("...") literals in ApexEditorPanels.cpp are fixed.Note: The v3.1.0 sources still did not compile on UE 5.8: a separate fix (2026-10-24) was needed for wrong member and type names, invalid UPROPERTY ToolTip syntax, a uint32 replicated property, missing includes and a LevelSequence plugin entry. Engine support below 5.7 is not proven.Partial
V3.1-2V3.1-2. Real 8-step setup wizard (level instance OR Blueprint SCS+CDO, no duplicates)ApplyFullWizardConfigurationWithUndo() handles all 8 request steps for a level instance or a Blueprint (SCS, inherited component handler and CDO) inside an FScopedTransaction: explicit camera/spring arm, creation without duplicates (Apex_EnsureComponentsWithoutDuplicates), category presets with bPreserveExistingProfileValues, Enhanced Input actions, target sockets, fixes and a pre-apply summary (BuildWizardPreApplySummary).Note: The Slate wizard UI only shows steps 1, 2&3, 4, 6 and 8; the Enhanced Input (step 5) and per-fix toggles (step 7) are only reachable through the API.Partial
V3.1-3V3.1-3. Interactive execution camera studio (play/pause/stop, live controls, explicit victim, viewport safety)The studio has a phase selector, a normalized timeline scrubber, Play/Pause/Stop-and-restore buttons, live Distance, Yaw Offset and Target FOV spin boxes, save-to-asset, and cleanup when the bound viewport closes, PIE starts or the map changes (ValidateBoundViewportOrCleanup).Note: There is no explicit attacker/victim picker (static previews pass no victim; playback uses the wizard's step-6 target), no curves-vs-Level-Sequence choice, no height/side/intensity/entry/exit controls and no debug checkboxes.Partial
V3.1-4V3.1-4. Visual preset library (framing sketch, unique _01/_02 duplication, per-category apply)Each card shows a framing sketch as text; DuplicatePresetToContentBrowserAsset() appends _01, _02... if the package exists; ApplyPresetByCategoryWithUndo() and Apex_ApplyPresetByCategoryToActor() change only the component matching the preset's category.Note: The framing "diagram" is a text string, not a Slate drawing; BuildVisualFramingPreviewDiagramWidget() does not exist.Partial
V3.1-5V3.1-5. Real camera trajectory (PreviousSafeCameraLocation -> candidate) and reserved trace budgetValidateAndSecureFinalCameraDisplacement() sweeps both SafeAnchorPoint -> DesiredCameraLocation and PreviousSafeCameraLocation -> CandidateLocation, re-validates any bStartPenetrating extraction, and the solver reserves ReservedFinalSafetyTraces for this step. When the budget runs out it returns the previous safe pose (not re-checked against the current world) or requests an abort.Implemented
V3.1-6V3.1-6. Explicit targeting of the camera binding and FieldOfView track in a ULevelSequenceEvaluateAnimatedSourcePose() resolves the camera via SequenceCameraBindingTag or the active UMovieSceneCameraCutTrack section (falling back to a binding whose name contains "Camera"), checks Sec->IsActive() and Sec->GetRange().Contains(EvalFrameNumber), and only reads float tracks whose property targets FieldOfView or CurrentFocalLength (focal-length values are used as FOV degrees).Implemented
V3.1-7V3.1-7. Complete playable demo (AApexDemoPlayableCharacter, visible geometry, tag-based cleanup)Spawns visible walls and a pillar (/Engine/BasicShapes), an AApexDemoPlayableCharacter auto-possessed by Player0 with spring arm, camera, Motion Warping, lock and execution directors, three humanoid dummies plus a corridor dummy and one giant (~5.6 m). Keys: Tab or middle mouse = lock-on, Q/E = switch target, F = execution (CustomAttackerMontage optional). ClearGeneratedDemoArenaInWorld() removes only actors tagged ApexLockDemoArenaActor.Note: Not fully playable: no floor is spawned, WASD/mouse movement and look are not bound (DemoMoveForward/DemoLook* exist but are never bound), the character and dummies have no meshes, dummies registered in the editor world are not registered in PIE (see U6), and no map or content ships with the plugin.Partial
V3.1-8V3.1-8. Non-regression of A1–A9, B1–B10, C1–C28 and 20 FAutomationTestBase suitesApexLockProAutomationTests.cpp contains 20 FAutomationTestBase suites covering v3.1.0 scenarios.Note: Docs/ComplianceMatrix_47_Plus_Usability_v3_1.md does not exist (only the v3.0 matrix ships). Test results were not verified, and several A/B/C requirements are only partial (see this matrix).Partial
V3.1-9V3.1-9. Official IAssetRegistry::GetAssetsByPackageName(FName, TArray<FAssetData>&) signature for non-overwriting duplicationDuplicatePresetToContentBrowserAsset() queries IAssetRegistry::GetAssetsByPackageName into a TArray<FAssetData>, combines FindPackage and FPackageName::DoesPackageExist, and increments _01, _02... without overwriting a loaded or on-disk asset.Implemented
V3.1-10V3.1-10. Explicit EApexCandidateVerificationState (Unverified, VerifiedObstructed, VerifiedFree) under a trace budgetCandidates start Unverified with ClearanceScore = 0 and VisibilityScore = 0; a candidate that could not be traced never gets an artificial 1.0. Verified-free candidates always rank above unverified ones, and if the chosen candidate is not sufficiently verified the solver does not adopt it.Implemented
V3.1-11V3.1-11. Strict handling of bShouldAbortCameraTakeover in static and dynamic preview with viewport restoreWhen SolvedFrame.bShouldAbortCameraTakeover is true, ApplyOrAbortPreviewPoseToViewport() never applies FinalSafeLocation (static PreviewProfileInViewport and dynamic PreviewDynamicStepInViewport/playback): playback stops, the bound viewport camera is restored, LastPreviewAbortReason is set and bWasLastPreviewAborted stops the Slate tick from restarting it.Implemented
V3.1-12V3.1-12. Runtime wiring of OnNearbyThreatDetectedDuringExecution via NearbyExternalThreatsCount without per-frame duplicatesUApexExecutionDirectorComponent::TickComponent reads SolvedFrame.NearbyExternalThreatsCount from the shared solver (no extra query) and broadcasts OnNearbyThreatDetectedDuringExecution only when the non-zero count changes (LastBroadcastedNearbyThreatCount), resetting when no threats remain and on full cleanup.Implemented

Requirements

  • Unreal Engine 5.7 and 5.8 — targeted, validation in progress
  • Epic plugins: Enhanced Input and Motion Warping
  • Blueprint-only and C++ projects; full C++ source

Scope limitation

Scope limitation

ApexLock Pro is a camera and targeting system. It does not include combat logic, damage, enemy AI, animations or execution animation assets: your project provides the attack and execution animations, ApexLock Pro frames them.

Type to search titles, sections and keywords.