Create a Custom Weapon Moveset

Setting Up Your Weapon File

Custom movesets are defined in JSON files within your mod's data folder. Create a new file in data/yourmodid/excap_weapon/ with a descriptive name matching your weapon.

Defining Moveset Actions

Your weapon file should specify:

• Basic attacks: Define light and heavy attack animations and damage values
• Combo chains: Link attacks together so hits flow naturally into follow-ups
• Special abilities: Add unique moves triggered by specific inputs or conditions
• Animation references: Point to the animation files that drive each action
• Damage properties: Set damage type, knockback, and hit detection ranges

Testing Your Moveset

Equip your custom weapon in-game and test each attack in the combo chain. Watch for:

• Smooth animation transitions between moves
• Proper hit detection on mobs and players
• Correct damage application
• Animation timing that feels responsive

If attacks feel sluggish or don't connect, adjust animation timing values or hitbox definitions in your JSON file. Use a test world with creative mode to iterate quickly without combat pressure.