Dungeon Tracker

A turn tracker for running dungeon crawls in D&D 5e. Each press advances one 10-minute exploration turn, rolls for wandering monsters, and puts the stat block in front of the GM when something turns up.

tracker.dungeongadgets.com

Features

• Turns and wandering monsters. Advance a turn and the app rolls the encounter check (d100, d20, d12 or d6 against a threshold you set), then the d20 encounter table. The dice are thrown on screen and land on the result.
• Encounters. The monster's stat block, lore, tactics and habitat, with the group size already rolled. The next turn stays locked until the encounter is resolved.
• Time. A turn count, an hour track of six turns, and a real-time torch timer that keeps burning while the page is closed.
• XP. Defeating a monster splits its XP across the party using the 5e encounter multipliers. Level-ups are tracked to 20, and undo takes back XP along with the turn.
• Three built-in tables (Shallow, Deep, Abyss) or your own, uploaded as CSV or JSON.
• Light and dark modes, keyboard play (Space to advance, Ctrl+Z to undo), and the session saves itself in the browser.

Custom encounter tables

Upload a table from Settings → Encounter table. It replaces the built-in table for that tier until you remove it. Use Download template to start from the current table.

CSV, one row per d20 result:

roll,name,cr,count,desc
1,Giant Rats,CR 1/8,2d4,Squealing in the walls
2,Ghoul,CR 1,1,A hunched figure feeding on a corpse

JSON takes the same fields, plus optional lore, tactics, habitat and a stats block:

[
  { "roll": 2, "name": "Ghoul", "cr": "CR 1", "count": "1", "desc": "A hunched figure feeding on a corpse",
    "lore": "Once a grave robber who ate the dead to survive." }
]

Files can be up to 1 MB and 100 rows. count accepts a number or dice (1d4+2).

Running locally

It's plain HTML, CSS and JavaScript with no build step and no dependencies. Serve the folder with any static server:

python -m http.server 8080

Then open http://localhost:8080. Tests use Node's built-in runner:

node --test

Path	What's in it
index.html, css/app.css	Markup and styles
js/rules.js	Dice, XP and encounter rules (pure, tested)
js/state.js	Session state and save migration (pure, tested)
js/tables.js	CSV and JSON table parsing (pure, tested)
js/dice.js	The 3D dice, drawn on a canvas
js/audio.js	Sound effects, synthesised with Web Audio
js/app.js	Rendering, actions and events
js/data.js	The built-in encounter tables

Licence

The code is released under the MIT Licence.

Game mechanics come from the System Reference Document 5.1, used under the Open Game License 1.0a; the full notice is in the app's footer. This is an unofficial fan tool, not affiliated with or endorsed by Wizards of the Coast.