ShoulderCam

over-the-shoulder third-person camera for PEAK. Pressing V cycles near/medium/far distance for third person then goes back to first person, tap X swaps shoulders and hold X lets you look around the character.

By csj

Last updated	3 weeks ago
Total downloads	859
Total rating	2
Categories	Quality Of Life Client Side Gameplay
Dependency string	csj-ShoulderCam-1.0.0
Dependants	0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack_PEAK

BepInEx pack for PEAK. Preconfigured and ready to use.

Preferred version: 5.4.75301

README

Shoulder Camera

This is a mod for PEAK that adds a over-the-shoulder third-person camera.

How it works

Starts in third person, over the right shoulder. The character is framed on the left side of the screen.
V cycles through third-person near, medium and far, then first person. First person is the game's original camera, the three third-person modes change how far the camera sits behind the character.
X swaps shoulders, and hold it to look around. Tap X to slide the camera to the other shoulder, hold X to look around the character with the mouse, then release to return. Character input is paused while orbiting.
Climbing works in third person. The game's climb check still casts from the player's first-person eye position, so walls remain grabbable over the shoulder.
Grabbing and placement in third person focus around the reticle. The interaction radius for items is extended to compensate for the camera being behind you, and placement items such as pitons and constructables use the centre reticle in third person.
Client-side only: other players are unaffected.

note: for complex moments or in tight areas i encourage you to use the first person mode instead.

Controls

Input	Action
`V`	Cycle third-person near, medium, far, then first person
Tap `X`	Swap camera shoulder
Hold `X`	Orbit around the character with the mouse

Both keys can be changed in the config file. The short press / hold threshold is adjustable with OrbitHoldSeconds. While orbiting, character movement and actions are paused so the mouse only controls the camera; release X to resume.

Installation

Requires BepInExPack for PEAK.

Gale / Thunderstore

Install through Gale or any Thunderstore mod manager. The package extracts to:

BepInEx/plugins/ShoulderCam/ShoulderCam.dll

Manual install

Copy ShoulderCam.dll into:

<PEAK>/BepInEx/plugins/ShoulderCam/ShoulderCam.dll

Configuration

On first launch BepInEx writes:

<PEAK>/BepInEx/config/mj.shouldercam.cfg

For a Gale profile, look under that profile's BepInEx/config/ folder.

Edit it while the game is closed, then relaunch.

Section	Key	Default	Description
1. General	`Enabled`	`true`	Master switch. Off = normal first-person camera.
1. General	`ThirdPersonByDefault`	`true`	Start in third person at the medium distance.
1. General	`StartOnLeftShoulder`	`false`	`false` = right shoulder (character on the left), `true` = left shoulder (character on the right).
1. General	`ToggleViewKey`	`V`	Cycle near, medium, far, then first person.
1. General	`SwapShoulderKey`	`X`	Tap to swap shoulders; hold to orbit.
1. General	`OrbitHoldSeconds`	`0.3`	How long the shoulder key must be held before orbit mode activates.
2. Camera	`Distance`	`2.4`	Medium third-person camera distance, in metres.
2. Camera	`NearDistance`	`1.7`	Near third-person camera distance, in metres.
2. Camera	`FarDistance`	`3.8`	Far third-person camera distance, in metres.
2. Camera	`ShoulderOffset`	`0.65`	Sideways offset, in metres. Larger = character farther off-centre.
2. Camera	`HeightOffset`	`0.25`	Camera pivot height above the head.
2. Camera	`TransitionSeconds`	`0.18`	Blend time between first/third person and into orbit mode.
2. Camera	`PositionSharpness`	`16`	How quickly the camera follows the character.
2. Camera	`RotationSharpness`	`28`	How quickly the camera aligns with aim.
2. Camera	`ShoulderSwapSharpness`	`14`	How quickly the camera slides between shoulders.
2. Camera	`CollisionRadius`	`0.18`	Sphere radius used for camera collision. `0` = raycast.
2. Camera	`ThirdPersonFovBonus`	`0`	Extra FOV in third person or orbit mode. `0` keeps the game's FOV.
3. Appearance	`ShowBody`	`true`	Show the local player's body and head in third person and orbit mode.
4. Interaction	`ThirdPersonGrabRadius`	`0.8`	Interaction sphere radius in third person. The game default is `0.5`.
4. Interaction	`ThirdPersonGrabRangeBonus`	`0.5`	Extra interaction reach in third person, in metres.

Get the Thunderstore App