FA: Player Extension Compat

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 |