Skip to content

Dungeon Master Assistant is a lightweight tool for managing tabletop RPG sessions, featuring a dice roller and initiative tracker optimized for low-resource systems. Built with Next.js and React, it started as an experiment in AI-generated code and continues to evolve with planned features like status tracking, custom dice calculations

Notifications You must be signed in to change notification settings

AyyyStew/DungeonMasterAssistant

Repository files navigation

Welcome to the Dungeon Master Assistant Repo

This is a tool designed to help run tabletop roleplaying games like Dungeons and Dragons, Warhammer 40k: Imperium Malidictum, Pathfinder, and more.

This tool was created to act as a dice roller and initiave tracker for most systems.

Check it out!

Rationale

This is a personal project I created after I kept forgetting initiatve turn orders while running a Warhammer 40K: Dark Heresy Game.

This project was created to run on computers with limited resources. The old hardware I run my DND games on would overheat using other trackers so this was built as a less resource intensive version of those.

This project was created mainly with the use of LLMs like ChatGPT 4 as an expirment to see how far I could peronsonally take AI generated code. The code base is a bit of a hot mess, but the website works and was functional for our dnd group. A lot of refactoring and seperation of concerns is needed. This was about as complex as I could I could push ChatGPT before it started introducing more bugs than features, overall though I learned a ton about Next.js, React, and prompt engineering.

Improvement Ideas

There are several more features I want to implment when the time and need arises:

  • Status Tracker - to keep track of whose posioned, on fire, or environemntal conditions
  • Custom Dice Calculator - to implemnt 'd' as a operator like + - / *
  • Non Character Entities - to allow for enivroment hazards or times
  • Customer Characters - to store character's stats and inventories
  • Character and Enitty Storage - To save time inputing data
  • Character, Entity, and Enviromental Hazard Library - For quick use
  • Encounter timeline - to visualize encounters and keep history

How to Setup and Run the Code

This is a Next.js project bootstrapped with create-next-app.

Getting Started

First, run the development server:

npm run dev
# or
yarn dev
# or
pnpm dev
# or
bun dev

Open http://localhost:3000 with your browser to see the result.

You can start editing the page by modifying app/page.tsx. The page auto-updates as you edit the file.

This project uses next/font to automatically optimize and load Inter, a custom Google Font.

Learn More

To learn more about Next.js, take a look at the following resources:

You can check out the Next.js GitHub repository - your feedback and contributions are welcome!

Deploy on Vercel

The easiest way to deploy your Next.js app is to use the Vercel Platform from the creators of Next.js.

Check out our Next.js deployment documentation for more details.

About

Dungeon Master Assistant is a lightweight tool for managing tabletop RPG sessions, featuring a dice roller and initiative tracker optimized for low-resource systems. Built with Next.js and React, it started as an experiment in AI-generated code and continues to evolve with planned features like status tracking, custom dice calculations

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published