Wiki 9Minecraft Shoulder Surfing Reloaded Mod Wiki
Shoulder Surfing Reloaded Mod Wiki › Configuration

Shoulder Surfing Reloaded Mod — Configuration

Controls and Keybindings

Shoulder Surfing Reloaded provides several default keybindings to adjust the camera position on the fly without opening a menu.

Action Default Key Description
Toggle Perspective F5 Cycles through First Person, Third Person Back, and Shoulder Surfing.
Swap Shoulder O Quickly swaps the camera between the left and right shoulder.
Move Camera Left Left Arrow Shifts the camera further to the left.
Move Camera Right Right Arrow Shifts the camera further to the right.
Move Camera Up Up Arrow Increases the vertical height of the camera.
Move Camera Down Down Arrow Decreases the vertical height of the camera.
Zoom In Page Up Moves the camera closer to the player.
Zoom Out Page Down Moves the camera further from the player.
Reset Camera Home Returns all camera offsets to their default configuration values.
Free Look Left Alt Allows the camera to rotate independently of player movement.

Configuration

The mod is highly customizable via the shouldersurfing-client.toml file or the in-game config menu. Settings are divided into several logical categories:

Camera Settings

  • offset_x / offset_y / offset_z: Defines the default position of the camera relative to the player.
  • camera_step_size: Determines how much the camera moves per keypress when using the arrow keys.
  • keep_camera_horizontal: If enabled, the camera will not tilt vertically when looking up or down.
  • replace_default_perspective: Whether the mod should override the vanilla third-person back view entirely.

Player Settings

  • adjust_player_transparency: Enables the fading effect when the camera is close to the player.
  • player_transparency_threshold: The distance at which the player begins to fade.
  • decoupled_camera: Enables or disables the ability for the player to move independently of the camera direction.

Crosshair Settings

  • crosshair_type: Choose between STATIC, DYNAMIC, or ADAPTIVE.
  • custom_raytrace_distance: Sets the maximum distance the dynamic crosshair will look for targets (default is 400 blocks).
  • adaptive_crosshair_hold_items: A list of item IDs (supports regex) that trigger the crosshair when held (e.g., minecraft:.*sword).
  • adaptive_crosshair_use_items: A list of items that trigger the crosshair only when being used (e.g., charging a bow).