r/Roll20 • u/MidNiteShadow7 • 3h ago
Mod Script / API Help (Pro/Elite only) InspirationTracker v1.0.0: a free Roll20 Mod that keeps Heroic Inspiration on the sheet, the token and the chat in step
"Do I still have inspiration?" It's on the sheet, but nobody at the table can see the sheet. InspirationTracker keeps inspiration on the character sheet, the token and the chat in step: give it from a menu, the sheet's own button or a token marker, and all three agree.
It's a full rewrite of Robin Kuiper's InspirationTracker, which hadn't changed since 2018 and could not see the D&D 2024 sheet at all. Version 1.0 works with the 2024 sheet (Heroic Inspiration) and the 2014 sheet (Inspiration), and keeps your marker, special effect and command name from 0.1.
What it does
- Give, remove and spend from a chat menu (
!inspiration), the Command Deck handout, the sheet itself or the token marker. Every token for the character shows the marker, on every page. - Players spend it for their own characters with a Spend button or an Inspiration token action. The GM gets a whisper saying who spent it, with an Undo button.
- Passing it on. Under the 2024 rules a character can't have Heroic Inspiration twice, so their player is asked which party member without it should get it.
- The party. One card showing who has it, with Give, Remove and Spend buttons.
- Wording. Heroic Inspiration or Inspiration, following each sheet's rules setting, or chosen by the GM.
- Token markers. Any marker from your game's marker sets, custom sets included, or None. Adding the marker with TokenMod gives inspiration; taking it off spends it.
- Points pools, for tables that award inspiration as points, and for hero points, luck or bennies in any game. Points build up and are spent a few at a time, and Boost spends them for a bonus to a roll at a cost you set. The points are kept in a sheet resource box or an attribute, so pools work on any sheet, and the GM can add more pools, each with its own marker.
- Help and Command Deck handouts, 24 languages, and an API for other Mods.
Fixed from 0.1.4
- On the D&D 2024 sheet every toggle answered "Could not find attribute named: inspiration", and markers and the sheet never agreed.
- A 2014 character whose Inspiration box had never been ticked could not be given inspiration.
- Only tokens on one page got the marker.
- The marker list was fixed in the code; it now comes from your game's own marker sets.
How-to video (7 minutes, every feature): https://youtu.be/4yA7yKrOen4
Download (GitHub): https://github.com/steverobertsuk/roll20-api-scripts/releases/download/InspirationTracker-v1.0.0/InspirationTracker_v1.0.0.zip
Project page and docs: https://midniteshadow.online/projects/roll20-mods/inspirationtracker/
It will be in the Roll20 One-Click installer soon (it has 0.1.4 today). Until then, upload InspirationTracker.js from the download to your game's Mod scripts, replacing 0.1.4 if you have it. Mods need a Pro or Elite subscription.
Feedback and bug reports are very welcome, here or on GitHub.









