Multiattack 5e

Multiattack 5e (MA5e) is a FoundryVTT module for the DnD5e system that streamlines the multiattack action. Users can perform several attack / damage rolls at once, and the output is condensed into a custom chat card.

Demo

Default (left) vs MA5e (right)

Multiattack Tool

Instructions

Extra Attacks with default dnd5e roller

• Roll the weapon item as normal (create the item chat card in the chat log)
• Select Attack / Damage on the chat card
• An additional input is added to the Attack and Damage dialog boxes
• Select the number of extra attacks to roll

Multiattack with default dnd5e roller

• Select a single token
• Click the Multiattack tool button in the token layer toolbar on the left (GMs can enable/disable this button for players)
• Check each item to be included in the roll and input how many of that item's attack/damage to roll
• Optional: Use the default buttons to save the entire multiattack configuration for subsequent attacks

The MA5e API has been opened to allow multiattacks to be made programmatically:

const weapons = ["Longsword", "Longsword", "Dagger"]; // Make two longsword attacks and one dagger attack
const rollType = "attack"; // rollType is set to "attack" by default, but can also be set to "damage"
const actor = canvas.tokens.controlled[0].actor; // GM users could pre-define multiattack rolls for various actors
game.MA5e.multiattack(weapons, rollType, actor); // rollType and actor arguments are optional (default to "attack" and "canvas.tokens.controlled[0].actor" respectively)

For Midi-QOL:

const weapons = ["Longsword", "Longsword", "Dagger"]; // Make two longsword attacks and one dagger attack
const actor = canvas.tokens.controlled[0].actor; // GM users could pre-define multiattack rolls for various actors
game.MA5e.midiMA5e(weapons, actor) // actor argument is optional (default set to "canvas.tokens.controlled[0].actor); note that this function is ASYNC

For Better Rolls for 5e

const weapons = ["Longsword", "Longsword", "Dagger"]; // Make two longsword attacks and one dagger attack
const actor = canvas.tokens.controlled[0].actor; // GM users could pre-define multiattack rolls for various actors
game.MA5e.brMA5E(weapons, actor) // actor argument is optional (default set to "canvas.tokens.controlled[0].actor)

Technical Notes

Extra Attacks with default dnd5e roller

MA5e hooks onto renderDialog and filters for attack/damage roll configuration dialogs. An extra attack selection element is injected into the application. The functions that drive the roll configuration dialog are patched to add the value of the extra attack selection element into the original attack/damage roll.

Item5e#rollAttack and Item5e#rollDamage are also patched to hook onto preCreateChatMessage to get original chat message data and to suppress the creation of that original chat message. The patched functions make extra rolls based on the original "prime" roll to generate an array of rolls which is rendered using a custom handlebars template to create a single chat card with all the roll results.

Multiattacks

The multiattack workflow takes an array of weapon item names and uses that to build a nested array of attack/damage rolls from the actor. The multiattack tool simply builds the weapon item name array and passes it to the multiattack function.

Dice So Nice!

Since the number of rolls being made could be quite large, there are world-scope settings that allow for GM users to enable/disable DSN animations. If using the MA5e custom roller, DSN animations can be enabled/disabled for attack rolls or damage rolls or both. This can be set independently for rolls made using the attack/damage chat card buttons or with the Multiattack Tool.

For Better Rolls 5e users, since attack and damage rolls are made simultaneously, the only option is to enable or disable DSN animations entirely (for rolls made using the Multiattack Tool only; other rolls are not effected).

Changelog (see individual releases for full release notes)