Tasha

Tasha is a tool for creating 5e Dungeons & Dragons characters.

Supported rulebooks

• Player's Handbook
• Dungeon Masters Guide
• Mordenkainen's Tome of Foes
• Volo's Guide to Monsters
• Xanathar's Guide to Everything
• Tasha's Cauldron of Everything - Mostly
• Sword Coast Adventurer's Guide - Partially
• The Wild Beyond the Witchlight - Partially

QUICKSTART

Dependencies

• dice
• prompt_toolkit
• toml

Installation & Usage

Installation

# Clone the repository.
git clone https://github.com/mtttech/Tasha.git

# Change into the cloned repo. 
cd Tasha

# Create your virtual environment and install the requirements (if necessary).

Usage

Run tasha by running the following command python tasha.py.

It my be helpful to type the following command at the first usage.

• help: This command displays all the available commands and a basic description of their purpose.

To create a character, you must use the following commands. Details about each command are below.

• roll threshold: This command performs multiple underlying functions but primarily generates the six ability scores at thresolds between a total of 60-90. For example, if you use the command roll 60, Tasha will keep rolling your scores until they total or exceed 60. Once generated, you are given the option to assign your scores, choose your race/subrace (if applicable), gender, and background. If the add class action has been run and this action is run again, it will reset all the above values, including any chosen classes.
• add class class: This command sets your character's class. Run the command again, selecting a different class to multiclass to (minimum requirements are enforced). This command only works after the roll commmand has been run.
• set (alignment|name) value: These commands are hopefully self-explanatory. This command can "technically" be used at anytime but must be used before the save command.
• save: This command finalizes your character. It allows you to select a subclass (if applicable), choose skills, choose your ability score improvements (if applicable) and select spells (if applicable). Finally your character is saved to a TOML file in your $HOME/.config/tasha/characters directory. This command can only be run after the first three.