This mod enables content packs that register custom enchantments and special attacks for individual weapons or weapon types (sword, club, and dagger).

Enchantments

A content pack can add any vanilla weapon enchantment to an existing weapon. Check out the documentation for a list of enchantments that can be added. This mod also implements custom enchantment types, currently including:

heal - heals the user, either on hit, crit, or slay (similar to vampiric enchantment, but more flexible)
hurt - hurts the user, either on hit, crit, or slay
loot - drop either extra loot items, or a multiple of the monster's ordinary loot on death
coins - give the player coins either on damaging or killing a monster

Feel free to suggest new custom enchantment types.

Custom Special Attacks

Custom attacks are a sequence of "frames" that currently do one or more of the following:

change player facing direction
make the player temporarily invincible
play a special effect (currently lightning or explosion)
push the player in a direction
perform an ordinary or type-based vanilla special attack
create one or more customizable projectiles
play a sound

By default custom attacks replace a weapon's type-based special attack, but you can also require a modifier key to be held down for them to
trigger (left shift by default), by editing the config.json file (created when you first run the game).

By itself this mod does nothing, but there's an example custom content pack in the optional files that adds the following custom special attacks:

Galaxy Sword

attacks in all directions twice, rotating in a dizzying 720.

Lava Katana

attacks in all directions, rotating 360 degrees and shooting fireballs in 8 directions.

Galaxy Hammer

performs a ground slam attack that calls down the thunder of the gods and shoots it out in a semi circle from point of impact.

Wind Spire

Thrusts the player forward, performing an ordinary attack at the apex of the charge.

Here's a simple test showcase of some of these attacks:

Explanation of how to create your own content packs is here.

Mods that use this framework:

Advanced Special Attacks: adds special attacks to all weapons at different combat levels
AMF - Keyblade Magic for Cape Stardew: Adds Magic Enhancements for Keyblades found in Cape Stardew.
AMF - Poke Balls: A simple mod that adds pokeballs as weapons and when used as projectiles they have a higher attack damage.
Genshin Impact Weapons: adds some weapons from Genshin Impact with unique passive and active skills
Soul Calibur Weapons: Adds Soul Calibur weapon & Animated Soul Edge.
The Black Sword: adds a custom sword to the game with a custom heal enchantment and custom special attack sequence.
Treasure Hoarder Weapons: adds three weapons that have enchantments giving coins and extra loot

Technical

Requires SMAPI, uses Harmony.

Compatible with Mod Updater for automatic updates.

Code is at https://github.com/aedenthorn/StardewValleyMods.

If you want to complain or ask for help or help me test my mods, you can visit my Discord server.

A list of all my mods for Stardew Valley is available at https://www.curseforge.com/members/erinthe/projects.

Advanced Melee Framework