FA: Player Extension Compat

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

🎨 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