eimaj / dnd-battle-tracker

D&D Battle Tracker is a combat management tool for Dungeons & Dragons 5th Edition.

D&D Battle Tracker

D&D Battle Tracker is a combat tracker tool for Dungeons & Dragons 5th Edition (D&D 5e). Track the initiative and status of all creatures involved in combat with this D&D combat tracker!

Use

The D&D Battle Tracker is designed to run as a single HTML page in the browser (but does not require an internet connection).

You can either access the D&D Battle Tracker live or download a specific release of the dnd-battle-tracker.html file below and open it in your favourite browser.

Latest release (v5.7.1): dnd-battle-tracker.html List of previous releases

Motivation

As a new DM I found that I was frequently making mistakes during combat, such as:

• Forgetting who's turn it was or skipping a creature's turn altogether.
• Forgetting what conditions creatures were under.
• Doing maths wrong when applying damage to creatures (!)

It was clear that some automation would be helpful. There's a number of browser-based combat trackers out there at the time of writing:

• D&D Beyond
• Aide D&D
• DHMStark
• Donjon
• Harmless Key
• Improved Initiative
• Kassoon
• Orc Pub
• Roll20
• HeroMuster

Many of these systems are very feature rich and aim to provide tools beyond the combat tracker itself, which is great. However that does mean that they come with a learning curve and several are gated-off behind login screens.

This D&D Battle Tracker simply aims to automate the process of tracking combat using a pen and paper. It attempts to do this in a way that is as straight-forward and easy to use as possible. As such it does not do things like automate dice roles, provide custom character creation tools, battle map creation tools or provide content from the Player's Hand Book. Instead it focuses on automating the smaller things that are prone to error and often distract a DM from the combat itself.

Features

• Core DM features work entirely offline.
• Create a list of creatures who are involved in combat by adding a name, initiative score and health points for each one.
• Track creature status pre- and post-battle so active conditions carry into battle and persist when its over.
• Automatically order creatures by their initiative.
• Keep track of who's turn it is as combat progresses as well as what the current round is and how long combat has lasted.
• Keep track of creature conditions and any additional notes and how long they have been applied.
• Make it obvious when conditions or notes have been applied to help the DM not to forget to take them into account.
• Provide links to D&D Beyond's list of condition descriptions and monsters.
• Manage the health points of enemy creatures or NPCs allowing HP to be added and removed whilst supporting adding PCs to the creature list without HP.
• Allowing creatures to be killed/made unconscious and making it obvious to the DM that this has happened.
• Creatures can be added to or removed from the list at any time, even after combat has started.
• Save and load battles in case they continue into another session.
• Share your battle with your players so they can see the initiative order and follow along. Requires internet access.

Credits

• All icons taken from game-icons.net under the terms of the Creative Commons 3.0 BY license. See below for individual credits.
• Fonts provided by Google Fonts under the terms of the Apache License, Version 2.0. See below for individual credits.
• Critical Role for the inspiration.
• This application is not affiliated with, endorsed, sponsored, or specifically approved by Wizards of the Coast LLC.

Icons

• Play button icon by Guard13007
• Health normal icon by sbed
• Hearts icon by Skoll
• Icons by Delapouite:
  • Hamburger menu
  • Save arrow
  • Share
  • Broom
  • Padlock open
  • Contract
  • Expand
  • Trash can
  • Pencil
  • Player time
  • Next button
  • Previous button
• Icons by Lorc:
  • Magnifying glass
  • Crossed swords
  • Padlock
  • Skull crossed bones
  • Charm

Fonts

• Open Sans font by Steve Matteson
• IM Fell Great Primer SC font by Igino Marini

Development

Checkout and install

 $ git clone [email protected]:Paul-Ladyman/dnd-battle-tracker.git
 $ cd dnd-battle-tracker
 $ npm install

To run

 $ npm start

To test

 $ npm test

Architecture

Release

• Update the version in package.json and in the Download section of this README.
• npm run build to build the project and package all the static resources into a single HTML file. This file will be made available under dist/dnd-battle-tracker.html.
• Push the results to the master branch.
• Create a release in Github and upload the dist/dnd-battle-tracker.html file.