| A1 | A1. 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 |
| A2 | A2. 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 |
| A3 | A3. 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 |
| A4 | A4. 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 |
| A5 | A5. 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 |
| A6 | A6. 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 |
| A7 | A7. 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 |
| A8 | A8. 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 |
| A9 | A9. 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 |
| B1 | B1. 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 |
| B2 | B2. 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 |
| B3 | B3. 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 |
| B4 | B4. 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 |
| B5 | B5. 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 |
| B6 | B6. 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 |
| B7 | B7. 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 |
| B8 | B8. Coordination between camera and character movementSets bOrientRotationToMovement and bUseControllerRotationYaw according to EApexMovementCoordinationMode while locked, and restores the saved flags in ClearLockOn(). | Implemented |
| B9 | B9. 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 |
| B10 | B10. 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 |
| C1 | C1. 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 |
| C2 | C2. 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 |
| C3 | C3. 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 |
| C4 | C4. 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 |
| C5 | C5. 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 |
| C6 | C6. 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 |
| C7 | C7. 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 |
| C8 | C8. 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 |
| C9 | C9. 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 |
| C10 | C10. 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 |
| C11 | C11. 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 |
| C12 | C12. 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 |
| C13 | C13. 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 |
| C14 | C14. 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 |
| C15 | C15. 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 |
| C16 | C16. 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 |
| C17 | C17. 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 |
| C18 | C18. 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 |
| C19 | C19. 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 |
| C20 | C20. 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 |
| C21 | C21. 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 |
| C22 | C22. 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 |
| C23 | C23. 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 |
| C24 | C24. 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 |
| C25 | C25. 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 |
| C26 | C26. 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 |
| C27 | C27. 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 |
| C28 | C28. 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 |
| M1 | M1. 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 |
| M2 | M2. 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 |
| M3 | M3. 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 |
| M4 | M4. 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 |
| M5 | M5. 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 |
| M6 | M6. 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 |
| U1 | U1. 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 |
| U2 | U2. 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 |
| U3 | U3. 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 |
| U4 | U4. 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 |
| U5 | U5. 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 |
| U6 | U6. 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 |
| U7 | U7. 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-1 | V3.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-2 | V3.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-3 | V3.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-4 | V3.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-5 | V3.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-6 | V3.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-7 | V3.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-8 | V3.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-9 | V3.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-10 | V3.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-11 | V3.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-12 | V3.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 |