⚔️ Weapon Mastery Automation 5E 2024

Bring the combat maneuvers of the 2024 Player's Handbook to life with perfect automation! This extension automates the effects of Weapon Masteries for the D&D 5E ruleset in Fantasy Grounds Unity. It reads weapon properties directly from the character sheet and applies conditions, damage, or saving throws automatically upon a hit or miss.

✨ Features & Supported Masteries

• 🛡️ Graze: Automatically calculates and applies the correct amount of damage and exact damage type (fully respecting resistances/immunities) when an attack misses.

• 🎯 Vex: Smartly applies a custom "Vex Target" marker and a conditional ADVATK effect. Guarantees Advantage only on your next attack against that specific creature.

• 💤 Sap: Automatically applies Disadvantage (DISATK) to the target's next attack roll. Includes built-in anti-stacking.

• 🐌 Slow: Instantly applies a -10 ft Speed reduction effect with built-in anti-stacking.

• 🦶 Topple: Automatically calculates the DC, rolls the saving throw, and applies the Prone condition if the target fails.

• 🤜 Push: Sends a handy reminder to the chat window based on the target's size (Large or smaller).

• 🪓 Cleave (Semi-automated): Hold the ALT key while rolling your extra attack to automatically strip your ability modifier from the damage.

• 🗡️ Nick (Semi-automated): Hold the ALT key to activate the mastery while rolling extra attack and damage.

• 🤖 NPC Masteries: Support for NPC mastery tags allows your monsters and villains to use masteries as well! Simply add tags to their actions.

🛠️ How to Use

It's incredibly easy! No complex effect coding is required.

👤 For Player Characters (PCs)

1. Open the weapon details in the character's inventory.

2. Check the "Mastery" box.

3. Roll your attack! The extension reads the mastery field and handles the rest.

4. Using Cleave/Nick: Hold the ALT key on your keyboard while making the extra attack and damage rolls.

👾 For Non-Player Characters (NPCs)

1. Open the NPC sheet.

2. Add the desired tag to the action title (e.g., Bite [TOPPLE_DC12]) or directly into the description text (e.g., Hit: 5 (1d6+2) slashing damage. [GRAZE_DMG3]).

Supported NPC Tags:

• [VEX], [SAP], [SLOW], [PUSH], [CLEAVE], [NICK]

• [TOPPLE] — Constitution save vs. fallback DC.

• [TOPPLE_DCX] — Constitution save vs. a specific DC (e.g., [TOPPLE_DC14]).

• [GRAZE] — Deals fallback damage equal to the attack modifier on a miss.

• [GRAZE_DMGX] — Deals exactly X damage on a miss (e.g., [GRAZE_DMG4]).

• [NICK_TWF] — Nick mastery that retains the ability modifier on the damage roll.

3. 🎯 Multi-Mode Actions: Single actions containing both Melee and Ranged options are dynamically split at logical boundaries (such as "or" or newlines). The extension automatically applies the correct mastery tag based on the specific type of attack roll performed.

Formatting Examples:

• Simple Action: "Warhammer Attack [PUSH]"

  Text: "Melee Attack Roll: +7, reach 5 ft. Hit: 31 (1d8 + 3) Bludgeoning damage."

• Multi-Mode Action: "Eldritch Burst Custom"

  Text: Melee Attack Roll: +12, reach 5 ft. Hit: 31 (4d12 + 5) Force damage. [TOPPLE_DC13] Or Ranged Attack Roll: +12, range 120 ft. Hit: 31 (4d12 + 5) Force damage. [PUSH]"

📺 Watch the Showcase Video

• YouTube: How it Works - Showcase Video

📦 Compatibility & Support

• Ruleset: Designed specifically for the D&D 5E (2024) Ruleset.

• Integration: Works perfectly on "Vanilla" FGU and is highly compatible with other third-party extensions (including BCEG).

🐞 Bug Report

There might be some edge cases or interactions I haven't caught yet. If you encounter any errors or features not triggering correctly, please drop a comment in the support thread!

📝 Changelog

v1.4 - NPC Weapon Mastery Support

• New Feature (NPC Mastery Automation): Full automation of weapon masteries for NPCs!

• New Feature (NPC Parameterized Tags): Added support for custom parameters directly within the tags, enabling custom DCs and miss damages: [TOPPLE_DCX], [GRAZE_DMGX], and [NICK_TWF].

• New Feature (Dual-Mode Actions): Single NPC actions can now support different mastery tags for Melee and Ranged options (e.g., Melee: [TOPPLE] Or Ranged: [PUSH]), utilizing smart keyword scoring and separator parsing.

v1.3.1 - Fix: Resolved an issue with Topple mastery untargeting the creature on save success.

v1.3 - Compatibility update for the big FGU 2026-04 ruleset update.

v1.2.2 - Off Hand bug resolved for the Nick mastery

v1.2.1 - Compatibility issue with BCEG

v1.2 - Nick Mastery Overhaul & QoL Updates

• New Feature (Nick Mastery Full Automation): Fully automates the Nick extra attack damage! The extension now automatically scans the character's Features and Traits for the "Two-Weapon Fighting" style. It dynamically removes your ability modifier from the damage roll if you don't have the style, or keeps it if you do (negative modifiers are always kept).

• New Feature (Smart Reminders & Player Agency): Cleave and Nick masteries now send a helpful chat reminder on your hit, but will not consume your "once per turn" limit until you actually roll the extra attack! You now have full tactical freedom to choose when to trigger the mastery during your turn.

• New Feature (Client Options): Added a new setting in the FGU Options menu (under "Client") allowing each individual player to customize how Nick activates. Choose between "ALT key" (default: hold ALT to activate and roll the extra attack like Cleave) or "Reverse ALT key" (the mastery is activated for every attack, you need to hold ALT to deactivate it).

• Improvement (Push Size Check): The Push mastery now actively reads the target's size from the Combat Tracker. If you hit a creature that is Huge or Gargantuan, it will output a "Push Failed" message instead of the standard reminder, perfectly matching the size limits!

• Improvement (Negative Modifiers): Cleave and Nick extra damage rolls now correctly retain negative ability modifiers instead of dropping them.

• Under-the-hood: Refactored turn-tracking logic for better performance, stability, and cleaner combat flow.
• Icon QoL & Brand New Icon: Changed some icons in the notifications to make it easier to understand the flow of the mastery, and added a brand NEW ICON for the mastery activation.

v1.1 - Bug Fix & QoL Updates

• Vex Duration: Increased Vex effect duration to correctly persist until the end of the attacker's next turn if not used.

• Cleave & Nick Limits: Added strict "Once per turn" tracking for Cleave and Nick chat reminders, perfectly synced with the Combat Tracker's active turn and round.

v1.0 - Initial Release

• Automation to Graze, Vex, Sap, Slow, Push, Cleave and Topple masteries.