Roll20 uses cookies to improve your experience on our site. Cookies enable you to enjoy certain features, social sharing functionality, and tailor message and display ads to your interests on our site and others. They also help us understand how our site is being used. By continuing to use our site, you consent to our use of cookies. Update your cookie preferences .
×

[Script, Update] Condition Tracker

1793787183

Edited 1793930294
MidNiteShadow7
Pro
API Scripter
Version 1.2.0 has been released Condition Tracker is a Roll20 API Mod for GMs who want to track token-focused conditions and custom effects as separate Turn Tracker rows. It applies configured token markers, announces changes in chat, stores active effects and saved long-term effects in state.ConditionTracker , and removes effects manually, through cleanup, on duration expiry, on token deletion, or when a tracked target reaches 0 HP. Version 1.2.0 is in the One-Click installer. There is a How-To video on YouTube; you can watch it here: <a href="https://youtu.be/qb7XzYJUtNc" rel="nofollow">https://youtu.be/qb7XzYJUtNc</a> [1.2.0] - 2026-10-05 Added Any-attacker Advantage / Disadvantage ( --attacker any ) : record effects that apply to whoever attacks a target (Help, Faerie Fire, Dodge) instead of to one named creature. --source is the creature granting it, the Turn Tracker row sits under the target, and the marker goes on the target. Row text reads  Next attack vs Goblin has advantage — Help (Owl) or  Attacks vs Goblin have advantage — Faerie Fire (Wizard) . Reason label ( --reason &lt;text&gt; ) : optional label for Advantage / Disadvantage shown in the row and chat (for example Help ). Single-use tracking ( --once true|false ) : marks an Advantage / Disadvantage as used up by the next attack. The row shows 1× in the pr column and the GM gets a Mark as Used button in the apply summary and the removal menu. --used &lt;condition-id&gt; : removes a single-use effect and announces it as used rather than removed. Start of source next turn duration : expires as soon as the source token's next turn begins, matching Help, Dodge, and similar effects. Presets ( --preset help ) : the Help preset pre-fills any-attacker Advantage, single use, the Help reason, and the start-of-turn duration, so the GM only picks the helper and the creature being attacked. Presets are listed at the top of the wizard's condition step for systems that support the effect type. Changed The Advantage / Disadvantage wizard now asks Who has advantage? (with an Any attacker option), Granted by (optional) , Against whom? , and How many attacks? instead of the generic Subject / Source / Target prompts. Advantage / Disadvantage held by one creature now places its marker on that creature (the source) rather than on the creature being attacked. Re-applying an identical effect now refreshes it (the old row is replaced and the duration restarts) instead of being rejected as a duplicate. Turn-anchored durations show ⏳ in the Turn Tracker pr column instead of a bare number; round counts still show the rounds remaining. The handout and help card describe the new options; other locales fall back to English for the new strings until npm run sync-locales is run. Fixed The wizard dropped the chosen subject at the duration and details steps, so it never reached the Turn Tracker row. The subject is now carried through, and into macros created from the apply summary. Corrupted templates in the de , af , it , pl , and ko locales printed literal mask tokens (for example PLATZHALTER0TOKEN ) in apply announcements and rows. The standard-conditions handout heading showed D&amp;D 5e in every non-English locale regardless of the active game system. The Spanish macro-reinstalled message listed only two of the five macros. Self-targeted condition rows were missing their emoji. Developer scripts/sync-locales.mjs no longer sends placeholder-only strings for translation and rejects any translation that loses a placeholder, keeping the English text instead. This was the cause of the corrupted locale templates. New src/presets.js module holds preset definitions.
1793930264

Edited 1793930272
MidNiteShadow7
Pro
API Scripter
How-To Video There is now a How-To video on YouTube; you can watch it here: <a href="https://youtu.be/qb7XzYJUtNc" rel="nofollow">https://youtu.be/qb7XzYJUtNc</a> In this video: • Getting started: the menu in chat (!condition-tracker --menu), the Help and Reference handout, the GM macros, and what the players see • The wizard: pick a condition, its source, its target and how long it lasts • Several targets: one condition on every selected token, each with its own Turn Order row • Presets: the Help preset gives advantage on the next attack, with a Mark as Used button • Reports and removal: everything on, and caused by, a token, and a Remove button for every effect • Dropping to zero: removing a creature's conditions, taking it out of the Turn Order, and moving it to the map layer • Settings: the config, choosing markers, actor classification, reinstalling the macros and handout, and Create Macro buttons • Translations: 24 languages for the replies, menus and handout Chapters: 0:00 Intro 0:16 Condition Tracker 0:24 What Does It Do? 1:02 Getting Started 1:59 The Wizard 2:36 Several Targets 3:11 Presets 3:39 Reports and Removal 4:09 Dropping to Zero 4:37 Settings 5:59 Translations 6:27 More