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.

⚙️ 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