FPModel x Compat

A technical compatibility mod designed to fix model issues when using First Person Model (FPM) alongside mods like Better Combat, Curios, accessories, etc…

🤝 Compatibility & Integrations

This mod acts as a technical bridge, harmonizing interactions between several major mods. Below is the list of currently supported integrations and what we've implemented for each:

⚔️ Combat & Gameplay

Better Combat
- Kinematic Alignment: Synchronizes arm rotations and body offsets with the camera pitch during complex attack animations.
- Attack State Dispatcher: Detects active combat phases to apply smooth rendering transitions.
Spell Engine
- Casting Synchronization: Extends kinematic fixes to spell-casting poses, ensuring your hands and staves point where you look.
Combat Roll
- Movement Stabilization: Smooths out body rendering during rolls to prevent camera clipping and jitter.

🎒 Accessories & Equipment

Accessories & Curios API
- Universal Slot Hiding: Automatically hides head-related accessory slots (Head, Hat, Face, etc.) in first-person while showing your accessories to other players.
- Configurable Filter: Includes an ignoredAccessorySlots option to allow users to customize which equipment slots are hidden in first person.
Relics
- Custom Renderer Support: Specific fixes for Relics items that use unique rendering systems, such as the Piglin Mask and Chef's Hat, ensuring they don't block the player's vision.
Artifacts
- Scarf Visibility Logic: Implementation of a specialized texture-based filter to hide Scarves in first-person while allowing other necklaces and amulets to render normally.

💡 Compatibility Recommendations

If you are experiencing animation conflicts when using Better Combat alongside EMF-based texture packs (like Fresh Animations Player or Fresh Moves), we strongly recommend installing the Entity Player Compat mod. This bridge mod effectively synchronizes animation states, preventing the visual "glitching" or "stuttering" of caused by conflicting animation systems.

🎯 Our Mission

Initially born to bridge the gap within the Better Combat ecosystem, this project aims to evolve into a universal integration hub for First Person Model.

We want to ensure that FPM works seamlessly with every major gameplay and animation mod in the Minecraft community. While our current focus is maintaining absolute stability for our existing integrations, we are eager to expand our horizons.

Have a mod you want to see integrated?
Please open an Issue and tell us which mod integration you're looking for! We will evaluate and work on bringing it to life.

Contributions

Contributions are highly welcome! Whether it's a bug fix, a new mod integration, or improved math for the kinematics util, feel free to open an Issue or submit a Pull Request.

First Person Model Compat