Shoulder Surfing Reloaded: Camera Fixes & Additions

Camera fixes and additions for Shoulder Surfing Reloaded on Forge 1.20.1. Standalone. Integrations with Epic Fight, Better Combat, Better Lockon, and Iron's Spells are auto-detected when those mods are present.

Features

• Configurable overhead preset added to the SSR preset cycle to mimic Leawind's Third Person. Single keybind cycles right shoulder, left shoulder, overhead. SSR's own preset system is per-axis and can't represent a coupled "centered + high" overhead, so this layers one on top via SSR's plugin API.
• Auto face camera on attack. While you're swinging, the body and head match player.yRot so the body fully turns with the swing instead of getting stuck partway, the swing animation reads as forward, and the hitbox lands where the crosshair points. Works for any weapon, vanilla, modded, or Better Combat, for the full swing duration with no hardcoded timing.
• Smoothly transitions between shoulder presets when you cycle them while locked on, instead of snapping. (Lock-on integration: Epic Fight + Better Lockon.)
• Keeps the SSR shoulder offset stable during lock-on. Without this, the EF + BLO + SSR stack would zero out the lateral shoulder shift mid-lock and recenter the camera on the player.
• Hides the vanilla crosshair while you're locked on with Epic Fight, so you only see SSR's adaptive crosshair instead of two crosshairs at once.
• No camera-recenter wobble after releasing lock-on. The camera stays exactly where the shoulder offset put it.
• Sprinting backwards while locked on no longer makes the camera chase your movement direction. The camera stays on the enemy as it should.
• Body actually follows the crosshair while casting Iron's Spells in SSR decoupled mode, so projectiles spawn where you're aiming instead of where your body happens to be facing.
• Shoulder cycle / SSR keybind dedup. If you've bound shoulder cycle to the same key SSR uses for its own swap-shoulder (both default to O), only one swap fires per press.

Config

config/ssrcamerafixes-client.toml:

• cameraOverheadOffsetY - vertical Y offset for the overhead preset (default 1.2). The only value SSR's preset system can't represent on its own. X is forced to 0 in overhead, Z is inherited from SSR's offset_z setting.

Right / left X offsets, vertical Y, and back distance Z come from SSR's own config/shouldersurfing-client.toml.

Keybinds

• Shoulder Cycle - default O. Cycles right shoulder -> left shoulder -> overhead -> right.

Requires

• Minecraft 1.20.1
• Forge 47+
• Shoulder Surfing Reloaded 4.22.0+

Optional, auto-detected when present:

• Epic Fight 20.14.1+ (lock-on integrations: crosshair hide, offset preservation, smooth preset transitions, sprint-backwards lock, attack-on-target body align).
• Better Combat (auto face camera on attack covers BC's upswing + downswing for any weapon).
• Better Lockon (lock-on integration with EF).
• Iron's Spells 'n Spellbooks (continuous facing during casts).

License

MIT