Epic Fight Extra Sheath Fix

作者：epic_lover

修复 Epic Fight Extra 中收刀状态下的打刀：刀鞘、冲刺、防御和刀刃轨迹效果。

模组 Forge 修复前置库实用附属

介绍

介绍由机器翻译自 CurseForge 原页面，仅供参考。

Epic Fight Extra 出鞘修复

修复 Epic Fight Extra（epicfightx）1.2.1 中的出鞘（iai / battojutsu）架势，以及使用该架势的武器。

如果你的打刀刀鞘挂在腰间、出鞘架势下冲刺或格挡时刀刃没有拔出、武器拖尾没有延伸到刀尖，或者其他武士刀在出鞘时显示异常，这个模组就是为你准备的。

修复内容

1. 玩家处于出鞘架势时冲刺或格挡，刀刃不会拔出

Epic Fight Extra 1.2.1 使用 isHoldingWeapon() 检查“拔出刀刃”代码，将武器的 innate 技能与 passive 技能进行比较，因此结果总是 false。出鞘的打刀在挥砍（battojutsu_dash，出鞘攻击）或格挡时，看起来仍然处于出鞘状态。本模组修正了这项检查，让它按预期工作。只有一处例外：若在该处执行修复，会导致格挡架势直接回到待机状态，因此特意保留原样。

2. 打刀刀鞘挂在腰间，出鞘模型看起来像普通待机姿势

Epic Fight Extra 会渲染打刀本体：主手持刀刃，副手持刀鞘，出鞘时则使用刀刃收在刀鞘中的组合模型。许多武器资源包会替换打刀物品的皮肤，并将其指向原版渲染器，导致刀鞘显示在腰间。由 Paxi 强制加载的资源包甚至会排在任何模组自带内容之前，因此无法通过资源包覆盖。

本模组会在 Epic Fight 完成选择后，通过代码决定渲染器，因此无论加载了哪些资源包、加载顺序如何，都能正常工作。

3. 武器拖尾没有延伸到刀尖（BDHill 模型）

拖尾资源包与 BDHill 模型的刀刃长度和形状不同。使用 BDHill 打刀时，拖尾会贴合刀刃：从护手开始，恰好延伸至弯曲的刀尖，适用于普通攻击、出鞘攻击和 battojutsu 技能。颜色、纹理、持续时间和时机仍由你的拖尾资源包决定。

4. 其他武士刀类武器

其他模组中使用 battojutsu 被动技能的武器（Simply Swords 武士刀、Dungeons and Combat、兼容包添加的武士刀等）也会获得相同处理。这些武器没有刀鞘模型，因此：

出鞘架势：武器会反握在副手，与打刀刀刃收在刀鞘中的持握方式相同
其他情况：武器照常握在主手

武器是否出鞘取决于玩家的出鞘架势，而非物品本身。快捷栏中有两把处于出鞘状态的武士刀时，挥动其中一把再切换到另一把，都会立即显示正确状态。

运行要求

Minecraft 1.20.1，Forge 47.x
Epic Fight 20.14+
Epic Fight Extra 1.2.1（软依赖：没有该模组时，本模组不会执行任何操作，也不会崩溃）

客户端和服务器端都需要安装。刀刃/格挡修复在逻辑服务器上运行；渲染器和拖尾适配仅在客户端运行。

若想获得最佳的打刀出鞘效果，请使用BDHill 的“Reforge the Sword Edge”武器模型。组合式“刀刃收在刀鞘中”模型和拖尾适配均以这些模型为准；使用其他模型时，本模组会退回到仅显示刀鞘，并且不调整拖尾。

配置

config/efx_sheath_fix-client.toml（更改会立即生效，无需重启）

选项	默认	说明
`uchigatana.fixUchigatana`	`true`	使用 Epic Fight Extra 的渲染器渲染打刀（始终显示刀鞘）。
`other_weapons.fixOtherWeapons`	`true`	将普通武器／副手携带效果应用于其他拥有拔刀术被动效果的武器。
`other_weapons.extraItems`	`[]`	即使没有拔刀术被动效果，也要视为带鞘武器的物品 ID。
`other_weapons.excludedItems`	`[]`	必须保留自身渲染器的物品 ID。

备注

不会编辑或替换任何其他模组或资源包，也不包含第三方模型或贴图。带鞘打刀模型仅通过路径引用 BDHill 的模型。
已使用 Epic Fight 20.14.17 和 Epic Fight Extra 1.2.1 测试。
如果 Epic Fight Extra 后续修复了 isHoldingWeapon() 检查本身，那么刀身／护手部分就只是多余的了。

鸣谢

Epic Fight 和 Epic Fight Extra 的作者
BDHill 资源包：I_Black_Demon_I（模型）、Hilljiaotatizi（特效、维护）
Epic Fight: Resurrection 的武士刀（cdmoveset:katana、cdmoveset:phantom_katana）现在
默认包含在 other_weapons.excludedItems 中，因为它们自带刀鞘渲染器。