zbarovsky / encounter-tracker

A Dungeons and Dragons combat encounter tracker web application created to help game masters track combat scenarios for their players. It was built with EJS, NodeJs, along with a SQL Postgres database with API calls to the dungeons and dragons API.

Encounter Tracker Readme

Idea

Encounter tracker for DnD adventures to make lists of encounters and, when started, the order can be adjusted based on the intiative roll of each monster (or hoard of monsters), and PC's.

You're parties ready to fight that adult black dragon, initiative is rolled, and now you as the DM have to deal with the hassle of writing out and keeping track of the initiative order. WELL NOT ANYMORE! Now all that can be solved with my (soon to be created) encounter tracker. With it you can create your encounters ahead of time (no more making it up on the fly, even though we all know it happens all the time, and that's okay), and with simply adding their init roll, can adjust where in the initiative order they stand. The best part, this is doable for your players characters as well.

Wireframes && ERD

• Main Page: https://wireframe.cc/ndgoMT

• Create Profile: https://wireframe.cc/lpcfvt

• Profile List: https://wireframe.cc/XeBtUQ

• Monster Results: https://wireframe.cc/eUarXM

• Init Roll: https://wireframe.cc/ujqq5c

• Party Create: https://wireframe.cc/cSTwJj

• Party Profile Page: https://wireframe.cc/ODCURg

• ERD: https://dbdiagram.io/d/5efc19ef0425da461f041746

Tech Stack

• HTML
• CSS/Bootstrap
• JS/EJS
• Node
• Sequelize
• Axios
• Postgres
• DnD 5e API (http://www.dnd5eapi.co)
• A lot of dependencies

MVP

• Log in and have indivial profiles ✅
• Search monsters by name and get relevent information ✅
• add monsters to encounter list ✅
• show encounter list ✅
• make list moveable based on intiative roll ✅

Stretch

• Ability to add PC's and relevent stats to a list
• Add PC's to encounter list ✅
• Hoard rolls
• Init roll button ✅
• Multiple encounter lists ✅
• Update and track health during encounter ✅
• Ability to add custom monsters ✅
• Friends list (view other peoples encounters)

Routes

Method	Path	Purpose
GET	/	Render index (home) page
GET	/profile	Render users profile page with specific encounters
GET	encounter/run	get users monsters and reorder based on iniative in DESC order
GET	encounter/create	render page to create encounters to add to database
GET	encounter/	gets user encounters and post them on profile page
GET	encounter/view	renders encounter page and the monsters that are in the encounter
POST	encounter/	add title to encounter and add it to specific user
PUT	encounter/:id	update monsters initiative and health based on input/random roll button
DELETE	encounter/:id	Remove monster from specific encounter
GET	monster/	axios db call to API to get monster, post relevant info, and add monster to a specific user encounter
GET	monster/create	user creates own monster and adds to a specific encounter
POST	monster/	add monsters name, initiative, and health to database to be accessed by encounter list
GET	auth/register	route to register user
POST	auth/register	find or create user; name, email, password
GET	auth/login	route to login page
POST	auth/login	authenticate user upon login
GET	auth/logout	logs user out of app. Redirects to home page

Roadblocks

• A lot to complete in a week
• It's a lot of pages to build
• Not the best with CSS/Bootstrap to make page look clean
• Lots of different relationships between postgres tables, making sure they link properly will be difficult

Bugs

• If user adds an extra space at the end, they can't search for the monster.

Acknowledgements

• Link to my background image: https://wallpapercave.com/w/wp4786823
• Thanks to Emily, Tyler, and Daniel for testing my app at launch.