ThirdPersonMode

Third Person Mode

A BepInEx client-side mod for Mycopunk that adds a toggleable gameplay third-person camera.

Mycopunk already ships third-person models, animations, and an orbit camera (used for emotes/spectate). This mod reuses

those systems for free movement and combat, without the vanilla emote locks that freeze controls.

Features

Camera

• Toggle keybind (default: 0) with hot-reload config
• Over-the-shoulder orbit camera (configurable offset + distance)
• Scroll zoom while in third person
• Full movement & combat — no emote-style control locks
• Optional ADS → first person (on by default) for cleaner aiming
• Optional HUD hide in third person
• Optional start in third person on spawn
• Yields cleanly to death/spectate

Body animation

• Local third-person body uses character TP animation sets
• Idle / walk / run / jump / air-jump / jump-loop / land / slide / clamber
• Crouch animation set swap when available
• Crouch lowers the TP body (CrouchBodyOffset) so feet stay planted
• Body facing follows player yaw

Weapons & actions

• Held gun mesh attaches to the TP hand bone while in third person
• Restores first-person gun parenting on toggle off / ADS
• Equip / reload / fire / stow TP clips when the gun provides a ThirdPersonGearAnimationSet
• Melee and throwable TP action clips when available
• Throwable/utility meshes attach while that gear is active
• Wingsuit fly animation while airborne in the wingsuit

Controls

| Action | Default |

|---------------------|-------------|

| Toggle third person | 0 |

| Zoom (in TP) | Mouse wheel |

Change the toggle key and camera feel in the config file (hot reload supported).

Configuration

Config path:

BepInEx/config/sparroh.thirdpersonmode.cfg

| Section | Key | Default | Description |

|----------|---------------------------|----------|----------------------------------------------------------------|

| General | ToggleKey | Digit0 | Unity Input System key name |

| Camera | OrbitDistance | 3.25 | Default camera distance |

| Camera | MinOrbitDistance | 1.5 | Min zoom |

| Camera | MaxOrbitDistance | 5.5 | Max zoom |

| Camera | ShoulderOffset | 0.9 | Right-shoulder X offset (higher = body farther from crosshair) |

| Camera | ShoulderHeightOffset | 1 | Extra camera height |

| Camera | CrouchBodyOffset | -0.55 | Lower TP body while crouching (feet plant) |

| Camera | ScrollToZoom | true | Mouse wheel zoom |

| Gameplay | HideHudInThirdPerson | false | Hide main HUD in TP |

| Gameplay | AdsReturnsToFirstPerson | true | FP while aiming |

| Gameplay | StartInThirdPerson | false | Auto-enter TP on spawn |

Dependencies

• Mycopunk
• BepInEx 5.4.2403+ (Mycopunk pack)
• HarmonyLib (via BepInEx)

Building

dotnet build --configuration Release

Output: bin/Release/netstandard2.1/ThirdPersonMode.dll

Installing

r2modman (recommended)

Install via the Mycopunk community page.

Manual

Copy ThirdPersonMode.dll into BepInEx/plugins.

Known limitations

• Mag / dual-mag models are hidden on the TP body (FP reload still works)
• Guns without a TP animation set only show the mesh (no equip/reload/fire body anim)
• Aim-layer blending is simplified vs remote players
• Emote third-person and this mod can interact oddly if used together — prefer one at a time

Roadmap

• Polish aim/reload upper-body blending and mag visibility on TP body

Authors

• Sparroh

License

MIT — see LICENSE