Shoulder Surfing

Shoulder Surfing additions

AET backports selected modern Shoulder Surfing features: decoupled movement and aiming, player fading and omnidirectional sprinting. It also adds smooth camera follow and other third-person adjustments. These client features complement the 1.7.10 Shoulder Surfing mod; decoupled mode also works in vanilla third person when that mod is absent.

Configuration guide · All categories

Third-person positioning and perspective

Config category: camera.

Follow smoothing adds camera lag; clipping smoothing softens movement around obstacles. For player fading, keep the start distance larger than the end distance. FOV overrides only apply in third person. These settings share camera with Camera Overhaul.

Setting	Default	Range or format	Effect
cameraClippingSmoothing	0.5	0.0 to 1.0	Smoothing factor for third-person camera clipping prevention. 0 = instant snap (vanilla), higher = smoother transitions when the camera hits geometry.
cameraFollowSmoothing	0.8	0.0 to 1.0	Smooth camera follow in third person. The camera trails behind the player's position instead of being rigidly attached. 0 = instant follow (vanilla), higher = more lag.
cameraPlayerFadeEnabled	true	true / false	Gradually fade out the player model as the third-person camera gets very close (e.g. clipping against walls).
cameraPlayerFadeStartDistance	1.5	0.0 to 10.0	Camera-to-player distance at which the fade begins. At this distance the player is fully opaque.
cameraPlayerFadeEndDistance	0.5	0.0 to 10.0	Camera-to-player distance at which the player is fully invisible.
cameraSoundCentering	true	true / false	Place the audio listener at the camera position instead of the player in third person. Makes positional audio match the camera perspective.
cameraVerticalOffset	0.0	-1.0 to 1.0	Vertical offset applied to the third-person camera in blocks. Positive values raise the camera, negative lower it. Useful to compensate for mods that alter entity eye height during rendering (e.g. DBC/JBRA).
cameraFovOverrideEnabled	false	true / false	Override the camera FOV when in third person view.
cameraFovOverride	70.0	30.0 to 110.0	Camera FOV when in third person view. Only applies when cameraFovOverrideEnabled is true.
simplePerspectiveToggle	false	true / false	Make F5 toggle between first person and third person back, skipping the third person front view.

Decoupled movement

Config category: camera.

With Shoulder Surfing installed, activate its shoulder view. Without it, switch to third person. The camera can look independently while the body turns toward movement. Free-look uses the configurable key binding, Left Alt by default. A larger offset decay value keeps the released free-look offset for longer. Omnidirectional sprinting follows decoupled mode and has no separate config toggle.

Setting	Default	Range or format	Effect
decoupledCameraEnabled	true	true / false	Rotate the camera independently of the player body in active Shoulder Surfing mode, or in vanilla third person when Shoulder Surfing is absent.
decoupledCameraOffsetDecay	0.5	0.0 to 1.0	How fast the camera goes back after releasing alt. 0 = instant snap back, 1 = no decay (offsets persist).
decoupledCameraPlayerTurnSpeed	0.25	0.0 to 1.0	How fast the player body turns to face movement direction when decoupled. 0 = no turning, 1 = instant.
decoupledCameraTurningLockTicks	10	0 to 100	How many ticks the player body stays facing the interaction target after attacking or using. 0 = disabled.

Aiming

Config category: camera.

Action entries trigger while an item is being used; item entries trigger when held. bow is the default action. For thrown items, use entries such as minecraft:snowball. The @N suffix matches exact metadata and @N-M matches an inclusive range. The default potion range selects splash potions. Aiming couples the player body to the camera, and optionally transitions into first person.

Setting	Default	Range or format	Effect
decoupledCameraAimingActions	bow	List of text entries	Item use actions that trigger aiming mode (player body follows camera so projectiles fire at crosshair). Valid values: bow, eat, drink, block, none.
decoupledCameraAimingItems	Default list	List of text entries	Items that couple the camera when held (for instant-throw projectiles like snowballs). Player body faces crosshair direction so projectiles fire accurately. Format: "modid:itemname" (any meta), "modid:itemname@N" (exact meta), "modid:itemname@N-M" (meta range). Splash potions use meta 16384-32767.
decoupledCameraAimFirstPerson	true	true / false	Switch to first person while aiming in decoupled mode. If disabled, aiming still couples the player body to the camera while keeping third person.
decoupledCameraAimTransitionTicks	5	1 to 40	Duration of the aim-to-first-person transition in ticks (20 ticks = 1 second).
decoupledCameraAimTransitionEasing	smooth	linear, ease_in, ease_out, ease_in_out, smooth	Easing curve for the aim transition. Options: linear, ease_in, ease_out, ease_in_out, smooth.

Default decoupledCameraAimingItems

S:decoupledCameraAimingItems <
    minecraft:snowball
    minecraft:egg
    minecraft:ender_pearl
    minecraft:ender_eye
    minecraft:experience_bottle
    minecraft:fishing_rod
    minecraft:potion@16384-32767
 >