First Person Model Compat
Fix First-Person Model mod issues when using mods like Better Combat, Curios, accessories, and more!
8 config settings
Build 1.2.1 · checked 13 September 2026
Guides
Config
- Body Y Offset (Sneak)
body_y_offset— Adjusts the vertical body position when crouching to align with FPM. - Trigonometric Curve
curve_correction— Prevents the arm from 'running away' from the crosshair at steep angles. Higher values slow down rotation at poles. - Curvature Safety Floor
curve_floor— Ensures the weapon remains visible even at 90 degrees. 0.15 = 15% minimum rotation strength.
Show all 8 settings
- Look UP Dynamic Z-Shift
lookup_z_shift— Automatically pushes the arm forward when looking up to prevent camera clipping. Default 3.1 ensures full visibility at -90 degrees. - Look DOWN Extra Bias
lower_bias— Additional rotation applied ONLY when looking at the ground. Smooths automatically. - Camera Pitch Multiplier
pitch_multiplier— Factor applied to camera angle. Higher values make the arm follow the look angle more aggressively. - Bias Transition Speed
transition_speed— How fast the arm smooths between upper and lower look states. Smaller is slower. - Look UP Extra Bias
upper_bias— Additional rotation applied ONLY when looking at the sky. Smooths automatically.
Requires
| Mod | Needed | Versions |
|---|---|---|
playeranimator |
optional | * |
cloth_config |
required | * |
firstperson |
required | * |
bettercombat |
optional | * |
spell_engine |
optional | * |
combatroll |
optional | * |
accessories |
optional | * |
essential |
optional | * |
Frequently Asked Questions
What problem does fpm_x_compat solve?
It prevents visual clipping and corrects arm and body alignment when using First Person Model with combat animation mods.
How do you prevent arms from clipping when looking straight up?
Increase Look UP Dynamic Z-Shift in settings to push the arm forward at steep skyward angles.
What does Curvature Safety Floor do?
It enforces a minimum rotation threshold so weapons remain visible even when looking directly at ninety-degree vertical angles.
How do you adjust arm positioning while sneaking?
Use the Body Y Offset (Sneak) setting to calibrate the vertical crouching offset of your character model.
Download Links
- modrinth.com modrinth.com/mod/fpm-x-compat
- Source gitlab.com/twkod/fpm-x-compat
- Issues gitlab.com/twkod/fpm-x-compat/-/work_items