Epic Fight Extra Sheath Fix

Fixes the sheathed (iai / battojutsu) stance of Epic Fight Extra (epicfightx) 1.2.1 and the weapons that use it.

If your uchigatana scabbard sits on the waist, the blade is not drawn when you dash or guard from the sheathed stance, the weapon trail misses the blade tip, or other katanas look wrong while sheathed, this is for you.

What it fixes

1. The blade is not drawn when a sheathed player dashes or guards

Epic Fight Extra 1.2.1 guards its "draw the blade" code with isHoldingWeapon(), which compares the weapon's innate skill with the passive skill and is therefore always false. A sheathed uchigatana keeps looking sheathed while you swing it (battojutsu_dash, sheath attacks) or block. The mod makes that check mean what it was meant to mean. The one place where doing so would drop the guard stance straight back to idle is deliberately left alone.

2. The uchigatana scabbard sits on the waist, the sheathed model looks like a normal idle

Epic Fight Extra renders the uchigatana itself: blade in the main hand, scabbard in the off hand, and a combined "blade in scabbard" model while sheathed. Many weapon resource packs replace the uchigatana item skin and point it at the vanilla renderer, which puts the scabbard on the waist. Resource packs forced by Paxi even sit above anything a mod ships, so they cannot be overridden with a pack.

This mod decides the renderer in code, after Epic Fight made its choice, so it works whichever packs are loaded and in whatever order.

3. Weapon trail misses the blade tip (BDHill models)

The trail pack and the BDHill models were made for different blade lengths and shapes. With the BDHill uchigatana the trail is fitted to the blade: it starts at the guard and ends exactly at the curved tip, for normal attacks, sheath attacks and the battojutsu skills. Colour, texture, lifetime and timing still come from your trail pack.

4. Other katana-type weapons

Weapons from other mods that use the battojutsu passive (Simply Swords katanas, Dungeons and Combat, katanas added by compat packs, …) get the same treatment. They have no scabbard model, so:

• sheathed stance: the weapon is carried reversed in the off hand, the same way the uchigatana blade sits in its scabbard
• otherwise: the weapon is in the main hand as usual

Whether a weapon is sheathed is read from the player's sheathed stance, not from the item. With two sheathed katanas in your hotbar, swinging one and switching to the other shows the right state immediately.

Requirements

• Minecraft 1.20.1, Forge 47.x
• Epic Fight 20.14+
• Epic Fight Extra 1.2.1 (soft dependency: without it the mod does nothing and does not crash)

Install on both client and server. The blade/guard fix runs on the logical server, the renderer and trail fit are client only.

For the best looking sheathed uchigatana use the BDHill "Reforge the Sword Edge" weapon models. The combined "blade in scabbard" model and the trail fit are measured for them; with other models the mod falls back to showing just the scabbard and leaves the trail alone.

Configuration

config/efx_sheath_fix-client.toml (changes apply immediately, no restart)

Notes

• Does not edit or replace any other mod or resource pack, and ships no third-party models or textures. The sheathed uchigatana model only references the BDHill models by path.
• Tested with Epic Fight 20.14.17 and Epic Fight Extra 1.2.1.
• If Epic Fight Extra later fixes the isHoldingWeapon() check itself, the blade/guard part simply becomes redundant.

Credits

• Epic Fight and Epic Fight Extra authors
• BDHill pack: I_Black_Demon_I (models), Hilljiaotatizi (effects, maintenance)
• The katanas of Epic Fight: Resurrection (cdmoveset:katana, cdmoveset:phantom_katana) are now in other_weapons.excludedItems by default, because they ship their own sheath renderers.