The goal of this script was to make a simple customizable sword that people could use. It's not based on any existing Zelda game's frame data and so theoretically that should require a lot less work and a lot less setup, right? Right???

It wasn't. This thing is a mess. I am not proud of the unholy creature I have made. I cannot stress enough that this script is an experimental idea and you should come prepared for it to fight you as it has fought me.

But if you're brave enough, here we go again...

Update 3/6/26: Added bomb wall tapping, quick slash, expanded graphical settings for spin attack, and constants for directional offsets.
Update 3/8/26: Improved bomb wall detection, shield interaction, fine tuning script to tweak some settings per direction.
Update 3/12/26: Fixed a bug where the hurricane spin sparkle could show up without hurricane spin.

To begin with, include the dependencies (listed at the bottom) and set up the CONFIGs at the top of the script as instructed by the comments. Most important are the ones for default slash, charge walking, and spinning animations. Once these are set up, compile and assign the slots. There's quite a few of them. Either use auto assign or go down this checklist:

• [Item] CustomSwordItem
• [LWeapon] SwordHitboxTracker
• [LWeapon] SwordSparkle
• [LWeapon] SwordBeams
• [Combo] CustomSwordExtraProperties
• [Combo] SwordBeamData
• [Combo] SwordChargeComboData
• [Combo] CustomSwordFineTuning
• [Generic] TempLinkState_Generic
• [Generic] PlayerAnimUpdate
• [Generic] CustomSwordGeneric

With the scripts assigned, it's time to edit your item. Choose one of the zz item classes and give it the CustomSwordItem script for its active script slot. There's a bunch of settings under InitD, Attributes, and Flags. It would be too much to go over here but you can check the metadata labels and help buttons for instructions on what they all do.

Two of the settings on the attributes tab ask for combos.

Sword Charge Combos uses four combos to define extra animations for the sword's charging animations. These combos should have the SwordChargeComboData script for instructions.

Extra Settings Combo has a bunch of extra settings for the item. I ran out of attribute space in the item editor and so had to daisy chain combos onto it like this. This combo should have the CustomSwordExtraProperties script for instructions.

From the Extra Settings Combo's attributes, there are Beam Combos which control the graphics and properties of the sword's beams, if it has any. These combos should have the SwordBeamData script for instructions.

Directional Fine Tuning Combos is the first of four combos used for direction based positioning. If you don't need this degree of control, leave it as 0. These combos should have the CustomSwordFineTuning script for instructions.
After all this setup, your sword should be good to use. It's just a matter of tweaking the settings to your liking.

This script requires both TempLinkState.zh and PlayerAnim.zh.