Immersive First Person

Immersive First Person is a Valheim mod that adds a body-aware first-person camera while preserving vanilla controls.

The camera tracks the player's animated head when possible, keeps the local body visible, and avoids hiding the head by default so normal shadows are preserved.

Features

• Toggleable first-person mode.
• Animated head-tracked camera anchor.
• Vanilla mouse and movement behavior preserved.
• Body yaw can lock to the vanilla camera direction to avoid seeing your own back.
• Local body visibility restoration while first person is active.
• Head, hair, face, helmet, shoulder, cape, and back-item hiding are optional config choices.
• Head hiding is disabled by default to avoid headless shadows.
• Configurable FOV, near clip, camera offsets, and optional camera smoothing.
• Camera override pauses during inventory, menu, and minimap use, restoring the head when temporarily leaving first person.

Default controls

Recommended defaults

[Camera]
UseHeadTrackedAnchor = true
SmoothCamera = false
LockBodyToCamera = true

[Visibility]
HideHead = false
HideHair = false
HideFace = false
HideHelmet = false
ForceBodyVisible = true

Installation

Mod manager

Install through your preferred Valheim mod manager once the mod is available on Thunderstore or Nexus Mods.

Manual

1. Install BepInEx for Valheim.
2. Download the latest release ZIP.
3. Extract ImmersiveFirstPerson.dll.
4. Place it in:

Valheim/BepInEx/plugins/ImmersiveFirstPerson/

1. Launch Valheim once to generate the config file.

Compatibility

This mod changes camera placement and local player visibility. It may conflict with mods that heavily modify the player camera, character skeleton, animation rig, or local player rendering.

Development

Build with:

dotnet build -c Release

The project targets .NET Framework 4.8 and uses BepInEx with Harmony patches.

Changelog

1.4.1

• Added a new Dodge Where You Look config option.
• Fixed first-person dodge direction when Dodge Where You Look is disabled. Holding S before dodging now performs a backward dodge instead of forcing a camera-forward dodge.
• Fixed unintended foliage/world-object culling near the player. ImmersiveFirstPerson now restricts visibility changes to local player-owned renderers only.
• Improved renderer state restoration safeguards when entering/exiting first-person mode.

v1.4.0

Changed

• Improved head hiding using Blacksmith's Tools.
• Helmets now render as ShadowsOnly in first-person.
• Head shrink is now fallback-only.
• Improved compatibility with vanilla and custom helmets.

v1.3.3

Fixed

• Fixed HideHead matching weapon parts with head in mesh or material names.
• Improved HideHead behavior for helmets and characters where the head is part of a shared body mesh.
• Fixed helmet-slot transform compensation that could make equipped helmets appear far away or in the skybox.

v1.3.2

Fixed file upload

v1.3.1

Added

• Added first-person Shoulder Peek.
• Added config option to enable or disable Shoulder Peek.
• Added Shoulder Peek input mode config with Hold and Toggle behavior.
• Added configurable left and right peek keybinds.
• Added configurable peek offset and peek smoothing speed.

Changed

• Updated mod version from v1.3.0 to v1.3.1.

Fixed

• Shoulder Peek resets when leaving first-person mode to prevent stuck camera offsets.

v1.3.0 - Optimization Update

Added

• Added first-person graphics controls:

[Graphics]
FirstPersonShadowDistance = 30
FirstPersonShadowCascades = 0
UseOcclusionCulling = true
DisableCameraEffects = false

Changed

• First-person mode now captures and restores occlusion culling, shadow distance, and shadow cascades.
• First-person view distance and LOD stay unchanged for immersion.
• Camera effect disabling is optional and restores each component to its previous enabled state when first person ends.
• Head hiding now caches head bones and head-slot renderers instead of scanning the full player transform hierarchy every frame.
• HideHead now validates local-player ownership before mutating renderers or bones for multiplayer compatibility.
• HideHead no longer shrinks equipment skeleton head bones, fixing shoulder-linked helmets such as padded helmets rendering at reduced size.
• HideHead now compensates skinned head-slot renderers that use shrunken head bones, so helmet shadows keep their intended size while the renderer stays hidden from the camera.

Notes

• Set FirstPersonShadowDistance = -1 and FirstPersonShadowCascades = -1 to keep current game shadow settings.
• Existing generated configs keep their previous values until edited or regenerated.
• Actual FPS gains depend on the scene, hardware, world density, and other installed mods.

v1.2.2

Fix wrong file upload for real this time.

v1.2.1

Fixed wrong file uploaded.

v1.2.0

Added

• Added first-person support for more gameplay states that normally force third person.

  • Inventory
  • Crafting
  • Ships
  • Hold fast
  • Sitting / attached states

• Added attached camera lock for ships, seats, hold-fast points, and similar attachment states.

  • The camera now locks to a captured head-level body position while attached.
  • This reduces sailing rubberbanding and seated camera jitter.
  • Look movement is limited while attached to prevent extreme camera/body mismatch.

• Added configurable attached camera settings:

[Camera Overrides]
LockCameraWhileAttached = true
AttachedCameraExtraVerticalOffset = 0
AttachedCameraExtraForwardOffset = 0.08
AttachedCameraMaxYaw = 80
AttachedCameraMaxPitch = 55

• Added HeadBobAmount under Camera Motion.

[Camera Motion]
HeadBobAmount = 0.5

Changed

• Reworked head bob reduction.

  • HeadBobAmount = 0 now uses filtered head tracking.
  • HeadBobAmount = 1 uses full animated head movement.
  • This keeps the camera tied to the character while reducing motion sickness.

• Reworked HideHead.

  • HideHead is now the single visibility option for head clipping.
  • Removed separate hide options for hair, face, helmet, shoulders, and back items.
  • Head-slot equipment is hidden from the camera while preserving shadows where possible.
  • Held items remain visible.

• Improved the README.

  • Friendlier introduction.
  • Clearer feature list.
  • Recommended settings section.
  • Cleaner install and compatibility sections.
  • Added Ko-fi support link.

Removed

• Removed camera smoothing and its config options.

  • SmoothCamera
  • CameraSmoothing

• Removed the old visibility mode options.

  • RendererDisable
  • BoneShrink
  • ShadowsOnly as a user-facing option

• Removed extra body-part visibility toggles.

  • HideHair
  • HideFace
  • HideHelmet
  • HideShoulderPads
  • HideBackItems

Fixed

• Fixed first-person camera rubberbanding while sailing in attached states.
• Fixed seated and hold-fast camera placement showing the player head.
• Fixed head bob slider not having a noticeable effect.
• Fixed head hiding accidentally affecting held items.
• Fixed head hiding collapsing helmet/head-slot equipment.
• Fixed helmet/head-slot shadows being misplaced after hiding the head.
• Fixed visibility restoration when first person is disabled or temporarily suppressed.
• Reduced camera clipping from helmets and head-slot equipment.

v1.1.2

Added

• Added forced first-person camera override for gameplay states that normally push the camera back to third person, including inventory, crafting interactions, ships, hold fast, and attached states.

• Added HeadBobAmount under Camera Motion.

  • 0 keeps only filtered head tracking.
  • 1 uses full animated head movement.
  • Default: 0.5

Changed

• Reworked head bob reduction to use filtered head tracking instead of falling back to a stable eye anchor.

• Simplified visibility settings.

  • Removed separate hair, face, helmet, shoulder, back item, and renderer mode options.
  • HideHead is now the only head visibility option.

• HideHead now uses shadows-only rendering by default.

  • The head and head-slot equipment are hidden from the first-person view.
  • Player shadows are preserved.
  • Held items should remain visible.

Fixed

• Fixed the head bob slider not having a visible effect when camera smoothing was disabled.
• Fixed head visibility options accidentally hiding the entire player body.
• Fixed head hiding accidentally affecting held items.
• Reduced camera clipping caused by helmets and head-slot equipment in first person.
• Improved cleanup so hidden renderers are restored properly when first person is disabled or temporarily suppressed.

Notes

Old config entries may still exist in existing generated config files, but the mod no longer uses them. For the cleanest test, delete the old config file and let the mod regenerate it.

v1.0.2

ANOTHER README FIX

v1.0.1

README Fix lol

v1.0.0

Initial public release of Immersive First Person.

Added

• Toggleable immersive first-person camera for Valheim.
• Animated head-tracked camera anchor with fallback to the player eye transform.
• Body-aware first-person view while preserving vanilla mouse and movement controls.
• Body yaw lock to vanilla camera yaw to reduce seeing the player's own back in first person.
• Local player visibility restoration while first-person mode is active.
• Automatic head/body visibility restoration when first-person camera override is suppressed by inventory, menu, or minimap UI.
• Configurable camera offsets, field of view, near clipping, and optional camera smoothing.
• Optional visibility toggles for head, hair, face, helmet, shoulders, capes, cloaks, and back items.
• Debug renderer logging for compatibility troubleshooting.

Defaults

• UseHeadTrackedAnchor = true.
• SmoothCamera = false.
• LockBodyToCamera = true.
• HideHead = false.
• HideHair = false.
• HideFace = false.
• HideHelmet = false.

Notes

Head, hair, face, and helmet hiding are disabled by default to avoid headless shadows. These options remain available for users who experience clipping with specific characters, armor, or modded equipment.