史诗战斗兼容套件

Epic Fight 兼容套件

问题所在

Epic Fight 用其自带动画骨架替换了玩家的原版骨骼，并接管了玩家模型的渲染。一旦安装 Epic Fight，其他所有读取或绘制原版玩家模型的模组都会停止正常工作：

• Essential 的装扮和商店套装在角色战斗时会冻结在行走循环姿势。
• Essential 表情无法显示。身体会继续播放 Epic Fight 的待机动画，表情没有可依附的对象。
• GeckoLib 和 AzureLib 盔甲（如 Hazen 'n Stuff、Iron's Spellbooks、Cataclysm Spellbooks）会被烘焙成静态网格，丢失其自带的翅膀、布料和发光动画；对于 AzureLib 而言，还会回退到一条不存在的原版纹理路径，显示为紫色和黑色方块。
• Iron's Spellbooks 和 Cataclysm Spellbooks 的施法动画（基于 playerAnimator 库构建）无法播放，因为 playerAnimator 只能通过已被 Epic Fight 接管原版渲染路径工作。
• L'Ender's Cataclysm 的武器大多只是扩展了普通的原版物品，没有注册 Epic Fight 招式，因此它们无法作为应有的长矛、巨剑或拳套类武器进行战斗。

这些都不是那些模组单独存在的缺陷。本模组修复的是它们与 Epic Fight 之间的交互问题。

功能说明

Essential 装扮与商店套装：每帧从 Epic Fight 的骨架重新定位到原版模型骨骼上，使套装能够追踪实际播放的动画，而不是固定在待机姿势。

Essential 表情：当玩家播放表情时，本模组在表情持续期间将该玩家的渲染交还给原版管线，表情结束后再将控制权返回给 Epic Fight。

GeckoLib 盔甲（Hazen 'n Stuff、Iron's Spellbooks）：通过 GeckoLib 自身的渲染器实时渲染，而非 Epic Fight 的静态烘焙，因此翅膀、布料及其他内置动画可以继续播放，同时保留了烘焙所丢失的自发光/发光渲染通道。

AzureLib 盔甲（Cataclysm Spellbooks）：通过独立的代码路径采用相同的实时渲染方式，因为 AzureLib 与 GeckoLib 是拥有各自注册表的不同渲染系统。这解决了紫色缺失纹理方块的问题。

施法动画：与表情相同的接管方式。当 Iron's Spellbooks 或 Cataclysm Spellbooks 的 playerAnimator 施法动画处于激活状态时，该玩家在第三人称和第一人称下均通过原版管线渲染。

L'Ender's Cataclysm 武器：远古之矛、珊瑚之矛、珊瑚长戟、Astrape、Ceraunus、灵魂收割者、焚尽者、歼灭者、血肉粉碎者、灼烧者、三款拳套、潮汐之爪和 Athame 均已注册 Epic Fight 武器能力数据，因此它们可以使用应有的长矛、巨剑、拳套或匕首招式。

需求

• Epic Fight（必需）
• Minecraft Forge，1.20.1

其他所有模组均为可选。每项修复只会在其目标模组已安装时才会激活。

配置

每项修复都可以在 config/efcompat-client.toml 中开关：

• essential.fixCosmetics
• essential.fixEmotes
• geckolib.fixArmor
• azurelib.fixArmor
• playeranimator.fixCastAnimations
• playeranimator.fixFirstPersonCasts

兼容性说明

• 仅客户端。即使服务器或其他玩家没有安装也不会影响安全使用。
• 如果 Epic Fight、Essential、GeckoLib、AzureLib、playerAnimator 或 L'Ender's Cataclysm 的未来更新改变了某项修复所依赖的内容，该修复会回退到 Epic Fight 的默认行为，而不会崩溃。
• 不会修改 Epic Fight、Essential 或其他列出的模组。它只读取它们的状态并调整玩家的渲染时机。