FA：玩家扩展兼容

FA: Player Extension 与其他模组的兼容性

Better Combat 兼容需要额外的资源包才能正常工作！ 请同时安装 FA: Player Extension × Better Combat —— 否则视觉修复将不会生效。

📖 关于

FA: Player Extension Compat 是 FA: Player Extension 资源包的非官方附属模组。 它通过暴露自定义的 EMF 动画变量并应用针对性的 mixin 补丁，修复 FA: Player Extension 与受支持模组之间的视觉冲突——无论你在做什么，都能让你的玩家模型看起来正常。

⚠️ 本模组为非官方作品，与 FreshLX 或 FA: Extensions 项目无任何关联。

✨ 特性

▶ is_playeranimator_active EMF 变量 —— 让 FA: Player Extension 资源包能够检测 PlayerAnimator 何时正在播放动画，从而避免 EMF 动画之间的冲突。

▶ Better Combat 身体倾斜修复 —— 修复使用 Better Combat 攻击调整时，在第三人称下抬头或低头导致的躯干不必要旋转问题。

▶ 动画黑名单 —— 配置哪些 PlayerAnimator 动画应被兼容逻辑忽略（例如不应阻断 EMF 的闲置循环动画）。

▶ Iron's Spells 'n Spellbooks 兼容 —— 即将推出。

📦 所需模组

本模组需要安装以下模组：

模组	原因
Entity Model Features (EMF)	提供资源包所使用的动画变量 API
Entity Texture Features (ETF)	EMF 的必需依赖
PlayerAnimator	提供本模组桥接的玩家动画系统
Better Combat	其 mixin 被修补以实现身体倾斜修复的模组

🎨 资源包 —— 部分兼容补丁还需要专用的资源包才能正常工作。 每个受支持的模组都有其对应的资源包，列于下方。请只安装与你的整合包相关的资源包。

⚙️ 配置

配置文件位于 .minecraft/config/fape_compat-client.toml。

[general]
    # 不应被视为激活状态的 PlayerAnimator 动画 ID。
    # 示例："mymod:idle"
    animation_blacklist = []

将动画 ID 添加到 animation_blacklist 可防止它们触发兼容逻辑。 这对于持续运行的闲置动画非常有用，否则它们会一直抑制 EMF。

🔗 兼容性