Track Command¶
Track your own "X per day" resources — class features, magic, and item charges — and refresh them when you rest.
Usage¶
/track add name:<text> uses:<number> # Define a new tracker (uses defaults to 1)
/track use name:<text> # Mark off one use
/track restore name:<text> # Hand one use back
/track list # Show all of your trackers
/track edit name:<text> uses:<number> # Change a tracker's uses per day
/track remove name:<text> # Delete a tracker
Description¶
Shadowdark has many abilities and items that can be used a limited number of times per day — for example, a Halfling's Stealthy ("Once per day, you can become invisible for 3 rounds"), a Knight of St. Ydris's Demonic Possession (3 times per day), or a magic item like a Staff of Healing usable once a day. Rather than hard-coding each one, the Track command lets you define your own things to track:
- Define a tracker with a name and a number of daily uses (defaults to 1)
- Mark off a use during play as you spend it
- Restore a use if you marked one off by mistake
- List all of your trackers and how many uses remain
- Edit how many uses a tracker has per day
- Remove a tracker you no longer need
Trackers live on your character's combatant during initiative, alongside HP and luck tokens. When you /rest, every tracker is refilled to its maximum.
Options¶
name- The name of the thing to track (required foradd,use,restore,remove,edit; autocomplete suggests your existing trackers)uses- How many uses per day the tracker has (optional foradd, defaulting to 1; required foredit; minimum 1)combatant- The combatant whose trackers to act on (optional, autocomplete on player characters in initiative)- Players: limited to their own selected character
- DMs: can target any combatant by name
- If omitted, uses your currently selected character
Examples¶
Define a tracker — a once-per-day ancestry ability, a 3-per-day class talent, and a once-per-day magic item. uses defaults to 1, so you can omit it for once-a-day things:
/track add name:Stealthy
/track add name:Demonic Possession uses:3
/track add name:Staff of Healing
Mark off a use as you spend it:
/track use name:Demonic Possession
Hand a use back if you marked one off by mistake:
/track restore name:Demonic Possession
See everything you're tracking:
/track list
Change how many uses a tracker has (e.g. a talent that improved):
/track edit name:Demonic Possession uses:5
Remove a tracker:
/track remove name:Staff of Healing
DM marking off a use on a player's tracker:
/track use combatant:Fighter Bob name:Stealthy
What Happens on Use¶
useincreases the number of uses spent by one and reports the uses remaining, e.g.Demonic Possession: 2/3 uses remaining.- Trackers are not blocked at zero — if you spend more than you have, the tracker reports it as overdrawn (e.g.
-1/3) and reminds you to rest. This keeps house rules and edge cases flexible rather than forcing a hard stop. restoredecreases the uses spent by one, never going below zero.
Resting¶
When you /rest, every tracker is refilled to its maximum number of uses. The rest message notes that your daily uses have been restored.
Notes¶
- Characters must be in the current initiative to manage trackers
- Trackers are session-specific: they live on the combatant and are removed when initiative ends
- Players can only manage their own character's trackers; DMs can target any combatant with the
combatantoption - Tracker names are matched case-insensitively
- A tracker name must be unique for a given character