Exopandora / ShoulderSurfing

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

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

Installation

Download Shoulder Surfing Reloaded from CurseForge or Modrinth or build from source.

Forge

Prerequisites

1. Make sure Minecraft Forge is installed

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 (CurseForge, Modrinth) is installed
3. Make sure Forge Config API Port (CurseForge, Modrinth) 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 (CurseForge, Modrinth) is installed

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

Manual: .minecraft/config/shouldersurfing-client.toml
Ingame: Install Forge Config Screens (CurseForge, Modrinth)

Version 2.9.7 and older

≥ 1.13: Manual: .minecraft/config/shouldersurfing.toml
≤ 1.12: Ingame: Mods → ShoulderSurfing → Config (Manual: .minecraft/config/shouldersurfing.cfg)

API Documentation

The API Documentation can be found in the wiki. It currently allows other mod developers to define custom rules for when and what items should have adaptive crosshair functionality.

Building From Source

Clone the repository and run the following command in the root directory of this repository:

gradlew build

The binaries for each platform can be found in the following directories:

Platform	Path
Forge	./forge/build/libs
Fabric	./fabric/build/libs
NeoForge	./neoforge/build/libs

FAQ

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 mod pack?
A: Yes.

Incompatibility

Shoulder Surfing Reloaded is known to be incompatible with the following mods (a-z):

• Better Third Person
• CameraOverhaul
• Nimble
• The One Probe
• Valkyrien Skies

License

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