Hark! The D&D Tracker be thy indispensable squire, aiding Dungeon Masters in their noble endeavors. This application doth bring order to the chaos of Dungeons & Dragons, allowing DMs to swiftly record session details, call forth monsters, NPCs, and items, all at a moment's notice. The Encounter Tracker dost ease the burden of managing battles, displaying turn order and tracking the status of thine champions.
For Dungeon Masters, swift access to vital knowledge is crucial. In times of adventure, DMs are ever engaged in seeking information, which may slow the flow of the game. Thus, this humble tool provideth a means to store all relevant matters in one place, so that thou mayst attend to the game with utmost efficiency.
The D&D Tracker lets you store and manage all campaign data, ensuring you can access critical details with ease during your sessions.
Follow these steps to get your D&D Tracker up and running:
Make sure you have the following installed:
- Any working operating system
- Integrated Development Environment (IDE) such as IntelliJ IDEA
- XAMPP for database management (Only if you want to develop locally using your own database)
- Download the repository: D&D Tracker GitHub Repository
- Extract the contents of the ZIP file.
- Run the application via the JAR file which is located in the following files: bp2-dnd-tracker > out > artifacts > bp2_dnd_tracker_jar > bp2-dnd-tracker.
- Optionally, place the JAR file on your desktop for quick access.
- Download the repository: D&D Tracker GitHub Repository
- Extract the contents of the ZIP file.
- Open the project in your IDE (IntelliJ).
- Start XAMPP, and ensure both Apache and MySQL are running.
- Click on the 'admin' button to access phpMyAdmin.
- Import the database file into the localhost phpMyAdmin.
- Run the application via IntelliJ, or use the standalone D&D Tracker JAR.
- Optionally, place the JAR file on your desktop for quick access.
- Java Development Kit (JDK) version 21.0.1 or higher. Download it from Oracle's website.
- No specific configurable options are required for setup.
- Java version 8 or higher is required.
Once the tracker is up and running, follow these steps to maximize your experience:
- Read the welcome text to start your journey with the D&D Tracker.
- The session screen displays all saved sessions. To manage sessions:
- Click on Sessions in the navbar.
- Click on a session to view details, and choose Delete or Update as needed.
- To add a new session, click the 'Add Session' button.
- The monster screen displays all saved monsters linked to your sessions. To manage monsters:
- Click on Monsters in the navbar.
- View, delete, link, or update monsters from the respective screens.
- To link a monster to a session, use the menu button to select a session.
- To add a new monster, click 'Add Monster' at the bottom of the screen.
- Similar to monsters, NPCs can be linked to sessions and managed as follows:
- Click on NPCs in the navbar.
- View, delete, link, or update NPCs from their respective screens.
- Add NPCs using the 'Add NPC' button.
- The item screen allows you to manage all saved items. You can:
- Click on Items in the navbar.
- View, delete, or update items as necessary.
- Add new items by clicking 'Add Item'.
- The encounter screen is vital for tracking combat during sessions. It provides:
- Turn order and HP tracking for monsters, NPCs, and players.
- Add characters and players to the initiative list, adjusting HP as needed.
- Add items for quick access during encounters.
The future possibilities for expanding the D&D Tracker are endless:
- Add Campaigns as an entity
- Allow monsters, NPCs, and items to have associated images
- Add cool widgets for map and picture generation
- Add a tutorial on how to use the applictation
For best practices, follow the Code Standards for this project.
- Tom Koevoets - LinkedIn - [email protected]
Thanks to everyone who contributed to this project and to the D&D community for their continuous support and inspiration!