merudo / mob-attack-tool

A module for Foundry VTT that offers a tool for handling mob attacks in the dnd5e system.

Mob Attack Tool

This is a module for Foundry VTT that offers a tool for handling mob attacks in the dnd5e system. The focus lies on offering GMs and players accessible and flexible tools to speed up large combat encounters. This module supports use of the Dice so Nice!, Better Rolls for 5e, Midi-QOL, Grouped Initiative, and Automated Animations modules.

How to install

You can install this module by searching Foundry's package browser or by pasting this url in the corresponding text field of Foundry's package installer: https://raw.githubusercontent.com/Stendarpaval/mob-attack-tool/main/module.json

How to use

After activating this module, a new button appears in the token controls bar. By default this button is only visible to users with the GM role, but this can be changed in settings. To begin using Mob Attack Tool, make sure you have at least one token selected and exactly one token targeted before you click the button.

A dialog window will appear, populated with the weapon options of the selected tokens and a checkbox. Tick the checkbox of the weapon(s) you want to use for the mob attack. Mob Attack Tool can also automatically select weapons what are part of a multiattack ability, or just the weapon option that deals most damage.

Clicking on the Mob Attack button in the dialog window will then whisper a message (by default to the GM) with the mob attack results. Furthermore, the weapon item is rolled the number of times that an attack would hit.

New

Make sure to read through the latest release notes to see what the newest features are.

Examples

This is what the Mob Attack dialog looks like (as of v0.2.18) with multiattack autodetect + autoselect enabled. (Also shown are JB2A Animated Assets triggered by a macro that makes use of Midi-QOL's On Use Macro field).

Below are some (older) GIFs that give a brief idea of how you can use Mob Attack Tool.

Click to show GIF of Mob Attack Tool

Click to show GIF of Mob Attack Tool + Better Rolls for 5e + Midi-QOL

For more elaborate examples and screenshots, please head over to EXAMPLES.md. (Note: the examples are currently quite outdated, but they should still give a general overview. Mob Attack Tool can do much nowadays than what is shown in the examples. Browse the latest release notes to find out what exactly.

Planned improvements

• Further (optional) automation of the initial selection of tokens -> In Progress
• Some documentation and better structuring of the repo -> In Progress
• Multiple target selection enhancements

Translations

Mob Attack Tool currently supports these languages:

• English
• Korean (translation provided by KLO (discord : KLO#1490). Thanks, KLO!)

Inspirations

• This module was inspired by Multiattack 5e.
• The map shown in the examples was made by Printable RPG Spellarena. You can check out more of their beautiful maps on the Spellarena Patreon.

Contributors

• Juanfrank has kindly given feedback and helped me out with condensing damage formulas.
• mike-marshall0164 has fixed various aspects of the individually rolled attacks.
• Many thanks to members of the League of Extraordinary Foundry VTT Developers for module development advice, including how to set-up GitHub Actions.