FirstPersonView ModelReplacementCompat

First Person View - ModelReplacementAPI Compatibility Patch

A lightweight patch enabling seamless first-person rendering for custom humanoid models using ModelReplacementAPI alongside First-Person View (by seechela / se3ya).

Features

• Automated Replacement Detection: Automatically detects when ModelReplacementAPI instantiates a replacement avatar on a player controller.
• Adjustable Head Position / Height:
• Auto: Dynamically measures the vertical difference between the replacement model's head and the vanilla rig, aligning your eye camera directly with the custom model's actual eye height.
• IndividualSuits: Specify custom vertical offsets per suit in the config (e.g. Ashley: 0.10, Default: 0.0).
• Disabled: Standard camera placement with zero adjustment.
• Double Hands Fix: Eliminates duplicate hands when FirstPersonView's Hands option is set to Vanilla instead of ThirdPerson. Automatically suppresses the vanilla orange astronaut arms on custom models and ensures held items attach to the character's hand bone.
• Dynamic Headless Mesh Generation: Dynamically removes head/neck vertices from the replacement avatar's body mesh for local first-person cameras, preventing camera clipping into your own face or hair.
• Arms & Body Visibility: Full visibility of custom replacement model arms and torso in first person.
• Safe State Handling: Automatically re-syncs if the model is swapped or cleared during gameplay.
• No Overwriting Required: Installs alongside both mods without modifying existing assemblies.

Configuration

Options are located in BepInEx/config/com.v0id.firstpersonview.modelreplacementcompat.cfg:

• AdjustmentMode (Disabled, Auto, IndividualSuits):
• Auto (default): Automatically detects model head height relative to vanilla rig and adjusts camera.
• IndividualSuits: Uses suit-specific offsets configured in SuitHeadOffsets.
• Disabled: No camera height adjustment.
• ManualHeadOffset: General vertical offset (in meters) added in Auto mode or used as a fallback.
• SuitHeadOffsets: Comma-separated list of SuitName: OffsetInMeters pairs (e.g. Ashley: 0.10, Default: 0.0).

Requirements

• BepInExPack
• First_Person_View (by seechela) (>= 1.5.1)
• ModelReplacementAPI (by BunyaPineTree) (>= 2.4.20)

Installation

With Mod Manager (Recommended)

Click Install with Mod Manager / r2modman.

Manual Installation

• Ensure BepInEx, First_Person_View, and ModelReplacementAPI are installed.
• Extract FirstPersonViewModelReplacementCompat.dll into your BepInEx/plugins/ folder.