FA: Player Extension Compat
FA: Player Extension Compat bridges the gap between the FA: Player Extension resource pack and combat animation mods. It ensures EMF-driven player models stay intact while mods like Better Combat play their attack animations.
Compatibility between FA: Player Extension and other mods
Better Combat compat requires an additional resource pack to work! Install FA: Player Extension × Better Combat alongside this mod — without it the visual fix will not apply.
📖 About
FA: Player Extension Compat is an unofficial companion mod for the FA: Player Extension resource pack. It fixes visual conflicts between FA: Player Extension and supported mods by exposing a custom EMF animation variable and applying targeted mixin patches — so your player model looks right no matter what you're doing.
⚠️ This mod is unofficial and is not affiliated with FreshLX or the FA: Extensions project.
✨ Features
▶ is_playeranimator_active EMF variable — lets FA: Player Extension resource pack detect when PlayerAnimator is running an animation, so EMF animations don't fight each other.
▶ Better Combat body tilt fix — removes the unwanted torso rotation caused by Better Combat's attack adjustment when looking up or down in third person.
▶ Animation blacklist — configure which PlayerAnimator animations should be ignored by the compat logic (e.g. idle loops that shouldn't block EMF).
▶ Iron's Spells 'n Spellbooks compat — coming soon.
📦 Required Mods
This mod requires the following mods to be installed:
| Mod | Why |
|---|---|
| Entity Model Features (EMF) | Provides the animation variable API used by the resource pack |
| Entity Texture Features (ETF) | Required dependency of EMF |
| PlayerAnimator | Provides the player animation system this mod bridges |
| Better Combat | The mod whose mixin is patched for the body tilt fix |
🎨 Resource Packs — Some compatibility patches also require a dedicated resource pack to work correctly. Each supported mod has its own pack listed below. Install only the ones relevant to your modpack.
| Resource Pack | Required for |
|---|---|
| FA: Player Extension × Better Combat | Better Combat compat |
| (more coming soon) | Future mod compats |
⚙️ Configuration
The config file is located at .minecraft/config/fape_compat-client.toml.
[general]
# PlayerAnimator animation ids that should NOT be considered active.
# Example: "mymod:idle"
animation_blacklist = []
Add animation IDs to animation_blacklist to prevent them from triggering the compat logic.
Useful for idle animations that run constantly and would otherwise always suppress EMF.
🔗 Compatibility
| Mod | Status | Resource Pack |
|---|---|---|
| Better Combat | ✅ Supported | Required ↗ |
| Iron's Spells 'n Spellbooks | 🔜 Planned | Coming soon |
