D&D 5e Dynamic Character Sheet

Multi-Platform

• Windows, Linux, MacOS, Android, iOS
• Flet GUI
• Python Backend
• SQLite Database

File Structure:

• Project folder on Windows file system
• Use Windows for testing & file storage
• Use WSL (Linux) for git commands

Initial Dev Environment Setup:

Create Windows Virtual Environment:

python -m venv .venv_win

Install dependencies

pip install -r requirements.txt

Change python Interpreter

Ctrl + Shift + P → select virtual environment interpreter
Ctrl + Shift + P → Reload Window if necessary

If using WSL

Create Linux Virtual Environment:

python3 -m venv .venv

To run the UI (Powershell)

flet run .\main_flet.py

Dev Environment Routine:

Bash Activate Linux Virutal Environment:

source .venv/bin/activate

Powershell Activate Windows Virutal Environment

.\.venv_win\Scripts\activate

When installing a new library

pip freeze > requirements.txt

Seed Database

python -m scripts.seed_db

Resources

• https://github.com/BTMorton/dnd-5e-srd
• https://github.com/5e-bits/5e-database
• https://www.dnd5eapi.co/

TODO

• Add a License

Feature List

• Scrolling Text Area that records the last actions (took 5 damage, used spell, etc.)
• Health and Mana (Spell Slot) Bars connected to HP-Text
• Dice Roller with breakdown of what dice were rolled and why (not abstracted away)

Architecture

Models - Scripts Views Components database.py dnd5e.db events.py main_flet.py rules_5e.py