Getting The Cursed Dual Katana Working In Your Minecraft Instance
The mod itself is straightforward to install, but people consistently hit the same walls around dependency conflicts and attack speed desync. I spent about three weeks troubleshooting a server that kept crashing when two players wielded the blades simultaneously. The root cause wasn't the katana code itself, it was the animation library it calls. Once I figured that out, the fix took ten minutes. Before we get into installation, it helps to understand what you're actually installing. The mod adds a dual-wielded katana system with combo mechanics, sound effects, and special abilities tied to different stance switches. It borrows heavily from Japanese swordsmanship aesthetics but doesn't attempt historical accuracy. The "curse" aspect comes from a status effect that triggers after sustained combos, increasing damage output at the cost of health regeneration. That's the basic loop. The more interesting stuff is in the configuration files. The mod requires both Forge and the Animation Library mod as dependencies. Download version 1.20.1 of the Cursed Dual Katana from CurseForge, along with the matching Animation Library build. Put both in your mods folder, launch once to generate configs, then stop. Do not skip the config generation step. The default settings assume a single-player environment and will cause timing issues on a server with latency above 50ms.
Open cursed_dual_katana.cfg and adjust these three values before playing: set attack_cooldown_multiplier to 1.3 if you're on a server, set swing_sound_volume to 0.4 if you have other weapon mods installed (the default clashes with most combat mods), and enable dual_wield_swap_delay if you find yourself accidentally switching stances mid-combo. The last one adds a 0.2 second buffer between stance changes that prevents accidental inputs during fast keypresses. Here's the edge case nobody documents: the mod's combo counter desynchronizes between client and server when you're within range of another mod that modifies hit detection. I ran into this on a 1.20.1 pack running both the mod and a lightweight PvP overhaul. The combo system would register hits on the client but not the server, which meant players could see their own combos fill up while opponents took no damage. The workaround was simple but non-obvious. In the server config, I set sync_combo_updates to true and disabled the hit detection override in the PvP mod for katana-type weapons only. That isolated the conflict to just the combination of those two specific mods and everything else continued working normally. The combat itself works on a rhythm system rather than pure DPS. Each blade has a base swing speed of 0.8 seconds, but chaining attacks in sequence reduces the cooldown by 0.05 per consecutive hit up to a maximum reduction of 0.25. The practical effect is that spamming keys doesn't help. You have to time the inputs. The game provides audio cues through the swing sound that let you learn the rhythm after a few minutes of use. New players typically waste the first hour button mashing and wonder why their damage numbers are lower than expected.
The curse mechanic triggers after seven consecutive hits without missing. It applies a stacking debuff to enemies called "Cursed Mark" that increases damage taken by 5% per stack, up to 25% at max. The drawback is that your own health regeneration pauses while the curse is active. This is balanced because the DPS increase from the combo speed reduction already offsets the lost regen in most encounters. Against bosses with large health pools, the math works out in your favor. Against groups of weak enemies, you might be better off breaking the combo to let regen kick back in. If you're running a modpack and want to customize the weapon further, the JSON config files under the configs directory let you tweak damage values, combo thresholds, and curse activation timing. I changed the base damage from 9 to 7 and increased the swing speed slightly for a harder progression curve in my pack. This took maybe five minutes and immediately made the weapon feel less overwhelming in early game situations. The game recalculates damage formulas on each launch from the JSON, so no recompilation needed. The mod also adds a loot table entry for finding the blades in temples and ancient city variants. If you're using a datapack or custom loot table, make sure you don't override the cursed_dual_katana namespace or the items won't spawn. I learned this the hard way when a map maker told me the blades were appearing in my world but not dropping from chests. Their datapack had renamed the loot entry and broken the reference.
Get the Full Details
Known limitations: The mod does not support cross-mod weapon compatibility. If you're using a combat overhaul that rewrites the entire attack system, the katana's custom hit boxes will not integrate properly and you'll get phantom swings or missed detections. In those cases, you're better off using a standard dual-sword setup from the combat mod and skipping the katana entirely. There is no patch for this. The developers have stated on their Discord that full combat system integration is not on the roadmap. Another limitation: the mod is Java Edition only. There is no Bedrock version. If you're running on console or Windows Edition, you cannot use this mod. Period. Some people try to port it through third-party tools and end up with broken saves. Don't bother. Installation summary: get Forge 1.20.1, download the mod and Animation Library from CurseForge, drop both into mods, launch to generate configs, adjust the three server values I mentioned if applicable, edit JSON files for any balance changes, and test in singleplayer before putting it on a server. The whole process takes about 20 minutes if you read the config comments, which are actually helpful this time.
CurseForge link for the mod: search "Cursed Dual Katana" on CurseForge under Minecraft 1.20.1. The file ID is stable across updates so you don't need to chase a specific version number unless you're on a different game version. Match the Animation Library version to your Forge build and you should be good.
