HMK Macros for Foundry VTT

2025-11-10

Part of the code, in javascript, for the attack macro for FoundryVTT.

Combat Macro

I'm starting to prepare for my HarnMaster Kethira campaign. At the moment there are no HMK systems in any of the VTT. There is one in development for FoundryVTT, but it's not ready yet, and the developer has had health issues this past year so it's uncertain when it will be ready. There is one planned for Roll20, but its development has not yet started. So in the meantime, I've decided to use the Simple World-Building system just so that the players can have tokens on the map and use macros for combat rolls. They'll have their character sheet in editable PDF form, and I'll have my trusty HMK Toolkit to handle Initiative Rating Tracking, their character sheets, price list, etc.

I want to prepare in advance a series of macros for each character. So I made a JavaScript macro for combat. Here is a quick demo.

It's a simple macro but I think it will help a lot during combat. You can configure the default parameters at the top of the code, so you can use the same macro for attacks with different weapons or counterstrikes, for example.

The defaults parameters in the combat macro.

When you invoke the macro, a dialog will appear, which lets you change any parameter, including a modifier like fatigue or situational modifiers.

The macro dialog where you can change the parameters and include an EML modifier.

And a chat card will appear when you roll. If the roll is a success, it offers a button to roll the zone, location, and impact dice all at once.

The success result of the combat macro.

The results of the zone, location, and impact rolls.

Skill Test

The macro bar with the block macro highlighted.

I include an attack, a block, and a counterstrike macro for each weapon. Since a block is just a skill test, I made a simpler skill test without the additional dice. This can be used for any skill test, and it lets you enter an EML modifier like the combat macro.

The result of a sword block.

Using the macros

Both macros are available as a single download on my resource page. It's a .zip file, which contains 2 JavaScript files. Simply open them in a text editor, copy the content and paste it into a Foundry VTT 'script' macro. Change the default parameters at the top and save.