Lock-On Priority
Makes Epic Fight's lock-on reliably win control of camera rotation and movement facing when it conflicts with ShoulderSurfing, BetterLockOn, and/or SSRCameraFixes — plus a small fix so the character stops looking at pass-through blocks (tall grass, flowers, etc.) that the crosshair happens to be over.
What it fixes
- Camera/head whip during lock-on — when multiple mods (Epic Fight's own ShoulderSurfing compat, BetterLockOn, SSRCameraFixes) all try to control the camera's facing at once, the result can be a rapid back-and-forth jitter. This mod re-syncs the camera to Epic Fight's own authoritative lock-on rotation as the guaranteed last write of the frame.
- Character running straight at the target regardless of movement input — a
known issue with BetterLockOn's own movement-facing logic. This mod hands full
movement/facing control to
lockonmovementfixduring lock-on instead. - Looking at grass/pass-through blocks — Epic Fight's look-direction raycast used a block's outline shape instead of its collision shape, so decorative blocks like tall grass would visually pull the character's gaze down. Redirected to use collision shape instead.
Priority behavior
This mod is a compatibility layer, not a replacement for any of the mods above. It automatically picks one of two behaviors depending on what's installed:
- SSRCameraFixes installed → full trust, hands off completely. SSRCameraFixes
- BetterLockOn's native behavior is used as-is.
- SSRCameraFixes absent →
lockonmovementfixbecomes the sole movement/facing authority during lock-on (BetterLockOn still provides target selection/UI, just not movement-facing).
Requirements
- Epic Fight (required)
- ShoulderSurfing, BetterLockOn, lockonmovementfix — all optional, but at least ShoulderSurfing + one of BetterLockOn/lockonmovementfix is the intended use case (third-person lock-on play).
Known limitations
- When SSRCameraFixes is not installed, ShoulderSurfing's own "Camera Coupling" toggle has no effect on lock-on movement/facing specifically (it still works normally everywhere else). This is an intentional trade-off for reliable, jitter-free movement.
- The pass-through-block look fix depends on an internal (non-API) BetterLockOn method name; if a future BetterLockOn update renames it, this specific fix will silently stop applying without affecting anything else.
Compatibility
Client-side only. Built for Forge 1.20.1.
