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.
• Dynamic Headless Mesh Generation: Clones the replacement avatar's body mesh and dynamically excludes/shrinks head/neck vertices for local first-person cameras. This ensures:
  • No clipping into your own face or hair when looking down.
  • Zero camera clipping or obstruction while moving, emoting, or looking around.
• 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.

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 via Thunderstore / r2modman.

Manual Installation

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

Changelog

[1.1.0] - 2026-09-17

• Added configurable head position / camera height adjustment option (Disabled, Auto, IndividualSuits).
  • Auto: Automatically measures height differences between replacement models and vanilla rigs.
  • IndividualSuits: Allows specifying custom vertical camera offsets per suit.
• Fixed double hands rendering when FirstPersonView's Hands option is set to Vanilla instead of ThirdPerson.

[1.0.0] - 2026-09-17

• Initial release of compatibility patch between LC-FirstPersonView and ModelReplacementAPI.
• Dynamic headless mesh generation for custom humanoid models.