Fighting Game · Guides & deep dives

V2 Camera Soft Lock-On

angle gates, yaw and pitch clamp limits, blend speed, line-of-sight requirement, and mode blend time.

4sections1 minread
Markdown source
On this page

The camera soft lock-on layer biases the current camera rotation toward an eligible target without forcing a full lock. It selects targets from deterministic candidate data, applies strength and blend alpha, clamps yaw and pitch bias, and exports the adjusted camera-manager mode.

Runtime Surface#

  • FV2CameraSoftLockOnConfig configures bias strength, target distance and angle gates, yaw and pitch clamp limits, blend speed, line-of-sight requirement, and mode blend time.
  • FV2CameraSoftLockOnState carries the current camera pose, base camera mode type, FOV, current target id, and current bias alpha.
  • FV2CameraSoftLockOnInput carries delta seconds and whether soft lock is enabled.
  • FV2CameraSoftLockOnTarget carries target id, location, priority, eligibility, and line-of-sight state.
  • FV2CameraSoftLockOnEvaluation returns selected target data, desired target rotation, biased rotation, yaw and pitch bias, bias alpha, target score, mode spec, and validation issues.

Bias Rules#

  1. Invalid config, state, or input is blocking.
  2. Invalid target entries are skipped and reported as non-blocking issues.
  3. Targets must be eligible, within distance, within angle, and line-of-sight visible when line-of-sight is required.
  4. Target score combines priority, distance score, and angle score.
  5. Bias alpha ramps by BiasBlendSpeed * DeltaSeconds.
  6. Rotation bias is target delta * BiasStrength * BiasAlpha.
  7. Yaw and pitch bias are clamped independently so the camera never becomes a hard lock-on camera.

Camera Manager Export#

EvaluateCameraSoftLockOn fills ModeSpec with the state base mode type using id camera.soft_lock_on. BuildCameraSoftLockOnMode can export a custom id, priority, and active flag for a camera manager stack.

Validation Commands#

Run these targeted checks when touching soft lock-on:

bash
python3 V2/ue/Tools/check-v2-camera-soft-lock-on.py
python3 V2/ue/Tools/check-v2-camera-manager.py
python3 V2/ue/Tools/check-v2-ci-workflow.py
python3 -m json.tool V2/ue/Content/V2/Gameplay/Camera/CameraSoftLockOn_V2_Contract.json
python3 -m py_compile V2/ue/Tools/check-v2-camera-soft-lock-on.py