Fluffy Hero Maker

What is this?

For now this is a tabletop rpg assistant, currently with DnD 5th edition and Classic Traveller options. It helps me generates characters on the fly, and access some data.

What games does it cover?

For now, Dungeons and Dragons 5th Edition (SRD) and Classic Traveller, but I plan to cover other systems too, later on. You are most welcome to offer ideas, I might add them.

How do I add data?

For DnD5

It uses json files to fill its databases, and the only files on this are from data that is part of the SRD (https://dnd.wizards.com/articles/features/systems-reference-document-srd) To add data, you can find templates of the json structures in the utils directory, and the data needs to be added in the databases/data/ proper directory depending on if you want to add races, spells, monsters, classes, or backgrounds.

How do I run it?

Requirements

• You need python 3.7 installed on your machine.
• You should be able to be fine by doing pip3 install -r requirements.txt to get all the dependencies.

The CLI version

• Ideally, just launching python3 cli_main.py -debug should do the trick. This is only in command-line interface for now, graphical interfaces are a pest.
• [also, this has only been tested on a linux machine with an Ubuntu distribution, so no guarantees]

The -debug option is required to have the database for now, at least on the first launch. If you make any addition in json files or want to update the database, you need to leave the -debug option on.

The internal Web page version

• The internal Web page uses Flask (https://flask.palletsprojects.com/en/1.1.x/)
• You need to make sure the environmental variable FLASK_APP is set to "app/main_flask.py"
• python -m flask run should have a web server up and running on 127.0.0.1/5000/ with the routes:
  • /dnd-random-character-gen/<name> displays a randomly generated dnd character with the name in <name> (does not yet display all the available information, nor does it yet make all the choices)
  • /random-dnd-spell displays a random spell and its information
  • /random-dnd-monster displays a random monster and its information
  • /all-dnd-monsters displays the list of monsters in the database
  • /all-dnd-spells displays the list of spells in the database
  • / displays a home page with links to previous routes
  • /classic-traveller-character-gen/<name> displays a randomly generated classic traveller character with the name in <name>, and as classic traveller creation goes, they can end up dead during their career. Just reload ;) You can then export the character as a json file, by using the Export button.
  • /classic-traveller-character-gent/<name>/<anything> you get a randomly generated classic traveller character that survived their term.
  • /classic_traveller-rand-party-gen displays a group of 4 randomly generated characters, all alive.
  • /classic-traveller-rand-world-gen/<name> displays a randomly generated world and its information, with a name in the URI.

What can I do with it?

DnD 5th

• cli version:
  • You can create a character, picking a name, race, class, and background.
  • You can display monster stats.
  • You can display spell stats.
• flask version:
  • You can create a random character.
  • You can display spell stats and lists.
  • You can display monster stats and lists.

Classic Traveller

• You can generate a character and save it at the end.
• You can generate a random world.

• cli version:
  • You can generate a character and save it at the end.
• flask version:
  • You can generate a character randomly and export it to json.
  • You can generate a party of 4 random characters.

What is lacking?

A lot (just look at the issues).

• All the SRD data taken into account. (DnD 5th)
• Cleaner code.
• Cleaner everything.
• Better display
• Enough automated tests. (current tests are made using pytest)

Why this name?

Because this world needs more fluffy things. Also it is a partially wrong name, as it is more of a fluffy-helper than a fluffy-hero-maker, but eh.

Danger zone

• High risk of things changing a lot because this is very flimsy.
• Also, high probability of bugs
• Also, I sometimes forget to use the python things, and reinvent the wheel for no reason

Licensing

Not exactly sure yet how I license this, so for now, it's a mess.

• https://dnd.wizards.com/articles/features/systems-reference-document-srd for the SRD document,
• The Traveller game in all forms is owned by Far Future Enterprises. Copyright 1977 - 2008 Far Future Enterprises. (CF : http://www.farfuture.net/FFEFairUsePolicy2008.pdf)

Can I help? I've seen some issue...

• Check the CONTRIBUTING.md to see more about how to contribute.