Epic Fight Compat Suite

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 武器 大多只是继承普通的原版 Item，没有注册 Epic Fight 招式集，因此无法按它们应有的长矛、大剑或拳套类武器进行战斗。

这些都不是上述任何一个模组自身的 bug。本模组修复的是它们与 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 武器：Ancient Spear、Coral Spear、Coral Bardiche、Astrape、Ceraunus、Soul Render、The Incinerator、The Annihilator、Meat Shredder、The Immolator、三个 Gauntlets、Tidal Claws 和 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 或其他列出的任何模组，只会读取它们的状态，并在玩家渲染时进行调整。