Skip to content

mtttech/tasha

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Tasha

Tasha is a tool for creating player characters for the 5th edition Dungeons & Dragons (2024) tabletop game.

Supported rulebooks

Below is a list of rulebooks incorporated into the program (more may be added as they become available).

Dependencies

The following dependencies are required.

Installation

Tasha can be installed by cloning the repo, building a wheel with poetry, and installing it with pipx.

git clone https://github.com/mtttech/tasha.git

cd tasha

poetry build

pipx install dist/tasha-0.*.*-py3-none-any.whl

Usage

Run Tasha by typing the following command.

tasha --help
Usage: tasha [OPTIONS]

Options:
  --new TEXT  Generates a new player character.
  --version   Show the version and exit.
  --help      Show this message and exit.

Create a character.

tasha --new Rowena

The program will send a series of prompts that will be used to generate your character.

You will be prompted to then save the finished character. Such characters will be saved as a .toml file within the same directory.

Below is an example of such a character.

alignment = "Chaotic Good"
armors = [ "Light", "Shield", "Heavy", "Medium",]
background = "Soldier"
feats = [ "Magic Initiate",]
gender = "Female"
hit_points = 22
languages = [ "Common", "Elvish", "Dwarvish",]
level = 3
name = "Rowena"
proficiency_bonus = 2
savingthrows = [ "Strength", "Constitution",]
size = "Medium"
skills = [ "Athletics", "Acrobatics", "Intimidation",]
species = "Elf"
speed = 30
spell_slots = [ 0,]
tools = [ "Artisan's Tools - Cartographer's Supplies",]
traits = [ "Fey Ancestry", "Darkvision", "Elven Lineage", "Trance", "Keen Senses",]
weapons = [ "Martial", "Simple",]

[bonus]
Strength = 2
Dexterity = 1
Constitution = 0
Intelligence = 0
Wisdom = 0
Charisma = 0

[cantrips]
Fighter = 0

[features]
Fighter = [ "Fighting Style", "Second Wind", "Weapon Mastery", "Action Surge (one use)", "Tactical Mind", "Fighter Subclass",]

[prepared_spells]
Fighter = [ "Sleep", "Shield", "Magic Missile",]

[attributes.Strength]
score = 17
modifier = 3

[attributes.Dexterity]
score = 14
modifier = 2

[attributes.Constitution]
score = 11
modifier = 0

[attributes.Intelligence]
score = 13
modifier = 1

[attributes.Wisdom]
score = 9
modifier = -1

[attributes.Charisma]
score = 13
modifier = 1

[classes.Fighter]
level = 3
hit_die = 10
subclass = "Eldritch Knight"

Languages