Skip to content

gwhitson/PythonDND

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TODO:

UI Formatting/Cleaning

change start menu entity manager into campaign manager where you can edit entities as well as encounters at least delete them...

fix initiative selection

PythonDND

alt text

An interactive map for hosting DND sessions. Approaching its beta release.

It will be up to the DM to find/create maps to use within the app, it is currently set to start at your monitors native resolution.

The app has the idea of a campaign which will have a unique (to it) list of entities, attacks, and encounters. Encounters within a given campaign will have access to all of the same entities. This will allow the DM to add their party members from the entity manager without creating an encounter specific entitiy.

Getting Started

alt text

The main menu screen allows you to create, or load campaigns, alter settings, and quit the game. The settings menu is where you can adjust keybinds. Special keys may require a specific syntax in order to not break. If a keybind is invalid, it will load the default keybind in its place. Campaigns are stored as sqlite .db files. They are under the 'res/saves/' directory and can be accessed directly through sqlite. This can be dangerous and create breaking bugs in your campaign file. Details on the campaign file and its implementation will be added under devloper notes.

Encounters and Campaign management

alt text

After either loading or creating a campaign, you will enter the following screen (a newly created campaign will have no encounterss by default and therefore the top portion will be blank). If an encounter has already been defined, you can select it from the list and load the encounter. Otherwise you can create an encounter.

Creating Encounters

alt text

After selecting the 'New Encounter' option, you will be presented with the menu above.

'Encounter Name' should be restricted to alpha-numeric characters.

'Map Size' should be two integers, representing the number of squares on the X axis and Y axis respectively, separated by the letter 'x'. (This will be adjusted in the future to have an 'X' entry box and a 'Y' entry box)

'Background' is a drop down menu showing all .png files in the 'res/maps/' directory. You can upload .png's to be used by adding them to this directory. This will be scaled to the current pixel size of the 'map' element within the main application. Because of this the image may be distorted.

Creating an encounter will send you back to the Encounter selection screen

In the Game

alt text

Once loading an encounter, you will be at the avove screen.

'Session Settings' and the 'Quit' option will be in the menu no matter the game state. Otherwise, the menu has two base states depending on whether or not combat has started. alt text

Before starting combat, you can click any entities on the map to prompt them to move within their movement speed. Once starting combat, you will be prompted to select your initiative ordering. Once submitted the game will enter combat mode.

With the game in combat mode, you will be presented with new items in the menu. This will show the current entity to act as well as their health, along with buttons for moving to the next and previous turns (next and prev turn buttons may be moved to session settings menu as it will ideally not be needed often). Below that will be the options to move and attack.

Selecting the 'Move' option displays the movement speed as a shaded circle around the entity displaying where they are able to move. Any click within the shaded region will move the current entity to the center of that square, even if it was just barely able to reach. If you have issues with this, the DM is in control and this has been made with the understanding that the DM should be able to do things at their own discretion.

In order to accommodate the wide variety of attacks and target ranges, attacks are not currently bound to any specific shape or distance of range (ex: cone, 30 ft) and rather you will simply select the entities that would be targetted by the attack, enter the roll to hit, damage roll, and check the box if the action grants you a bonus action before clicking 'Attack'. Clicking the 'Attack' button will apply check the roll to hit against the AC of the targets, and if it is greater than or equal to the AC, subtracts the damage roll from the targets HP. If the bonus action box was checked, the action is processed and the turn repeats.

Once an entities health drops to or below 0, they are no longer drawn on the map and when next/prev turn encounters them in the initiative ordering, they are skipped.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages