Macros

Macros let you generate standardized D&D 5e text directly inside an action. Instead of writing the full text manually, you insert a macro enclosed in curly braces, and Monstershuffler expands it into the appropriate rules text.

Macros automatically use the statistics of the creature they belong to, such as its attack modifier, save DC, proficiency bonus, or ability modifiers. This means a single action can be reused by multiple creatures while always producing the correct values for each one.

For example, writing:

{attack 1d6 bludgeoning}, and the target is Stunned.

might produce:

Melee Attack Roll: +5, reach 5 ft. Hit: 3 (1d6) bludgeoning damage, and the target is Stunned.

Using macros has several advantages:

• Consistency. Rules text always follows the same wording and formatting.
• Adaptability. Generated values automatically match the creature's statistics.
• Reusability. The same action can be shared by multiple creatures without modification.
• Less manual work. Complex rules text—including attack rolls, save DCs, damage expressions, and other game mechanics—can be generated from a short, readable syntax.

Macros available in the editor

Attack

{attack [<damage>] [<damage type>] [<options>]}

Damage

The damage argument supports two formats:

• Damage expression: A standard D&D 5e damage expression, such as 1d6, 2d8 + 3, or 4d10 + 2.
• Damage preset: One of the following keywords, which generates a damage expression based on the average damage per round for creatures of the monster's challenge rating:
  • weak — 25% of the average
  • medium — 50% of the average
  • strong — 75% of the average
  • full — 100% of the average
  • deadly — 150% of the average

For example, the following macro:

{attack weak bludgeoning}

might expand to:

Melee Attack Roll: +5, reach 5 ft. Hit: 7 (2d6) bludgeoning damage.