Skip to content

Monk's Tokenbar

Monk’s Tokenbar lets the GM request a saving throw or ability check from several tokens at once. Each target’s result appears as a row inside a single consolidated chat card, with the roll total, pass/fail state, and the requested DC if visible.

Controls are injected into each row of the consolidated card, so spends and grants happen in the same place the result is shown.

  • Spend (n) appears on every row the user owns that has not already been bumped, where n is the spendable Tenacity count. The button is disabled when no Tenacity is available to spend against that roll. Clicking it opens the standard Spend Tenacity dialog scoped to that row’s roll. Once the row is raised, the button is replaced with a +{amt} (now {to}) pill and the row total is patched in place. See Spending Tenacity for dialog behavior and caps.
  • +1 Tenacity (Grant) appears next to the Spend button for the GM when the Grant Button setting is enabled. Clicking it hands the row’s actor one Tenacity. See Earning Tenacity for the auto-grant rules that also fire on these cards.
  • Earned pill (+{n} earned) shows on rows where Tenacity was granted for the failure.
  • Refund pill ({n} refunded) shows on rows where a raise fell short and the configured refund percentage was returned.

Auto-grants on failure happen for both monks-tokenbar.updateRoll (saves) and monks-tokenbar.updateContested (contested rolls), respecting the NPC Support setting. Cards driven through midi-qol are skipped so Tenacity is not granted twice.

  • Row owner (player or GM): sees the Spend button on their owned row, the spend count in the label, and any earned or refund pills tied to their actor.
  • Other players: see the row’s roll total and any public pills, but no Spend or Grant buttons for actors they don’t own.
  • GM: sees Spend buttons on every owned row plus the Grant button on every eligible row when the Grant Button setting is on. The DC is always visible to the GM in the spend dialog; for players, the DC follows the DC Disclosure setting or the per-card reveal state.

After a player Spends on a row, the consolidated MTB card may briefly show stale Spend buttons on other rows until the next refresh. The row total and the bumped pill update immediately for the spending row; sibling rows catch up when the message next renders.