ShoulderSurfing

Shoulder Surfing Reloaded is a highly configurable third person camera mod for minecraft.

Features

• Over-the-shoulder camera - see what you are interacting with in 3rd person
• Decoupled camera - walk left and right without turning your mouse
• Free look (default: "left alt") - keep walking in a direction while looking in a different one
• Hotkeys to move the camera (default: "arrow keys", "page up" and "page down", "o" to switch shoulders)
• Corrective cross-hair positioning when using adaptive or dynamic crosshair
• Adaptive player transparency - fades the player model to transparent when view is obstructed
• Highly configurable - customize your 3rd person experience with many configuration options
• Client side only - no server mods required
• Plugin API - implement custom camera behaviours and compatibility features with ease

Please note that this mod modifies the camera position and player movement, which can be an issue for servers with strict anti-cheat. Use at your own risk!

Installation

Forge

Prerequisites

1. Make sure Minecraft Forge is installed
2. Make sure Forge Config API Port is installed [≥ 1.21]

Manual

1. Navigate to ".minecraft/mods"
2. Move "ShoulderSurfing-Forge-[VERSION].jar" into the folder
3. Follow the steps below

Launcher Settings

1. Select Forge as your profile
2. Launch Minecraft
3. Join a world or server
4. Use "arrow keys", "page up" and "page down" to adjust the perspective, "o" to switch shoulders

Fabric

Prerequisites

1. Make sure Fabric is installed
2. Make sure Fabric API is installed
3. Make sure Forge Config API Port is installed

Manual

1. Navigate to ".minecraft\mods"
2. Move "ShoulderSurfing-Fabric-[VERSION].jar" into the folder
3. Follow the steps below

Launcher Settings

1. Select Fabric as your profile
2. Launch Minecraft
3. Join a world or server
4. Use "arrow keys", "page up" and "page down" to adjust the perspective, "o" to switch shoulders

NeoForge

Prerequisites

1. Make sure NeoForge is installed
2. Make sure Forge Config API Port is installed [≤ 1.20.6]

Manual

1. Navigate to ".minecraft/mods"
2. Move "ShoulderSurfing-NeoForge-[VERSION].jar" into the folder
3. Follow the steps below

Launcher Settings

1. Select NeoForge as your profile
2. Launch Minecraft
3. Join a world or server
4. Use "arrow keys", "page up" and "page down" to adjust the perspective, "o" to switch shoulders

Configuration

Version 3.0.0 and later

• ≥ 1.21: Ingame: Mods -> ShoulderSurfing -> Config (Manual: Edit "..\.minecraft\config\shouldersurfing-client.cfg")
• ≤ 1.20: Install Forge Config Screens (Manual: Edit "..\.minecraft\config\shouldersurfing-client.toml")

Version 2.9.7 and older

• ≥ 1.13: Manual: Edit "..\.minecraft\config\shouldersurfing.toml"
• ≤ 1.12: Ingame: Mods -> ShoulderSurfing -> Config (Manual: Edit "..\.minecraft\config\shouldersurfing.cfg")

Plugin API

Shoulder Surfing Reloaded features a plugin API for third party mod developers. This allows for implementing custom camera behaviours and compatibility features without the use of invasive mixins. The documentation can be found in the wiki on GitHub. It explains step by step on how to create and register your own plugin, and how you can implement and register custom callbacks.

FAQ

Q: Why is the player not looking at the position of the crosshair when holding item x?
A: This needs to be configured using the config options "adaptive_crosshair_hold_items" or "adaptive_crosshair_use_items".
Q: Why is the player not rendered correctly when using shader pack x?
A: This is caused by player transparency effects of Shoulder Surfing Reloaded. Either disable them in the config ("adjust_player_transparency") and restart your game or report this to the authors of the shader pack.
Q: Can you port feature x to version y?
A: No.
Q: Can you port feature x to version y?
A: No.
Q: Can you port this to quilt, liteloader, rift, etc.?
A: No.
Q: Can I add this to my modpack ?
A: Yes.

License

MIT License, Original project by Sabar: Minecraft Forum, GitHub

Shoulder Surfing Reloaded

Shoulder Surfing Reloaded is a highly configurable third person camera mod for minecraft.

Features

• Over-the-shoulder camera - see what you are interacting with in 3rd person
• Decoupled camera - walk left and right without turning your mouse
• Free look (default: left alt) - keep walking in a direction while looking in a different one
• Hotkeys to move the camera (default: arrow keys, page up and page down, o to switch shoulders)
• Corrective cross-hair positioning when using adaptive or dynamic crosshair
• Adaptive player transparency - fades the player model to transparent when view is obstructed
• Highly configurable - customize your 3rd person experience with many configuration options
• Client side only - no server mods required
• Plugin API - implement custom camera behaviours and compatibility features with ease

Please note that this mod modifies the camera position and player movement, which can be an issue for servers with strict anti-cheat. Use at your own risk!

Installation

Configuration

≥ 1.21: Ingame: Mods → ShoulderSurfing → Config (Manual: .minecraft/config/shouldersurfing-client.cfg)
≤ 1.20: Install Forge Config Screens (CurseForge, Modrinth) (Manual: .minecraft/config/shouldersurfing-client.cfg)

Plugin API

Shoulder Surfing Reloaded features a plugin API for third party mod developers. This allows for implementing custom camera behaviours and compatibility features without the use of invasive mixins. The documentation can be found in the wiki on GitHub. It explains step by step on how to create and register your own plugin, and how you can implement and register custom callbacks.

FAQ

Q: Why is the player not looking at the position of the crosshair when holding item x?
A: This needs to be configured using the config options adaptive_crosshair_hold_items or adaptive_crosshair_use_items.

Q: Why is the player not rendered correctly when using shader pack x?
A: This is caused by player transparency effects of Shoulder Surfing Reloaded. Either disable them in the config (adjust_player_transparency) and restart your game or report this to the authors of the shader pack.

Q: Can you port feature x to version y?
A: No.

Q: Can you port this to quilt, liteloader, rift, etc.?
A: No.

Q: Can I add this to my modpack?
A: Yes.

License

MIT License, Original project by Sabar: Minecraft Forum, GitHub