Macro Support

Rollplay supports Macros in most text fields, written between square brackets: [ ].
Each macro is evaluated on the Player Character, and if it's valid, the brackets and everything inside are replaced with a live result.

eg: for a character with Strength 10, [{Strength} + 2] displays 12

Macro examples while editing

While editing

Macro examples as rendered

As displayed

As you type a macro, an auto-complete helps you fill it in, and the result is colour-coded so you can tell at a glance what it resolves to. If a macro can't be evaluated, its brackets turn red.

Info

Looking to style your text with bold, italic, or highlighted formatting? That's handled by Rich Text, which works in the same fields.

Macros come in two kinds: Value Macros and Link Macros.

Value Macros

A Value Macro evaluates an expression and drops the result straight into your text.

Reference an attribute

[Strength] — the character's current Strength
[{Hit Dice}] — the character's Hit Dice pool

Evaluate a formula

Anything you can write in a Formula works inside a macro:

[max(STR, DEX, CON, INT, WIS, CHA) + Proficiency] — your best stat, plus Proficiency

Roll dice inline

If a macro contains a d, Rollplay evaluates it as a Dice Pool — an expression of dice and numbers. When it resolves to a valid pool, the macro becomes clickable: tap it to roll right there in the text.

[d20] — a fixed d20 you can roll
[STR + {Hit Dice} + d8!] — a mix of an attribute, a dice pool, and a die, all rolled together on tap

Tip

The ! in d8! marks an exploding die — just one of the advanced dice operations Rollplay supports. Your macros aren't limited to flat dice; see Dice Rolls for the full set.

Type the name of another piece of content in brackets and the macro becomes a clickable link to it — perfect for referencing a Spell in a Feat's description, or the Condition a Spell inflicts.

[Fireball] — links to the Fireball spell
[Brave] — links to the Brave feat
[Blinded] — links to the Blinded condition

Links work by name resolution: if what you type matches the name of a piece of content, the auto-complete offers it. Because the auto-complete is colour-coded by content type, you can tell entries apart even when they share a name — for example, picking the Feat "Fancy" over the Attribute "Fancy".

Renaming is safe

A Link Macro stores a reference to the actual content, not just the text you typed. Rename that Feat, Spell, or Condition later and every macro pointing at it stays correct and updates automatically; you don't have to hunt down and fix references by hand.

Special macros

A few built-in macros pull common character details:

  • [Name] — Character Name
  • [Race] — Character Race (works for any defined Identity)
  • [Class] — Character Class

Auto-complete & Validation

Macro auto-complete

  • The auto-complete appears as you type and is colour-coded by type, so you can pick exactly the attribute, formula reference, or piece of content you mean.
  • A valid macro is coloured by what it resolves to — a plain value, a rollable dice pool, or a link.
  • An invalid macro shows red brackets, so mistakes are easy to spot.

Tip

For help writing the right macro for your game, contact us and we'll walk you through it!