Kanka Random NPC Creator

Hi, and thanks for taking the time to checkout this small project!

This mini project basically allows you to create as many random npcs as you want in your kanka campaign.

Setup:

1. Install python 3.x
2. pip install requirement.txt
3. Create a Personal Access Token on your kanka account as described here
4. Create a .env file based on the .env_example . The only env variable that you will probably want to modify is the APITOKEN
5. Run python3 ./npc-gen.py

By default it will check for a valid APITOKEN and complain if one is not set.

In additon to setting parameters in .env you can also specify some inline with the command. These options can be seen with --help

python3 ./npc-gen.py --help
usage: npc-gen.py [-h] [--host HOST] [--campaign CAMPAIGN] [--count COUNT]

Generate random NPCs in a Kanka campaign.

options:
  -h, --help           show this help message and exit
  --host HOST          Set API base DOMAINNAME (e.g. kanka.example.com)
  --campaign CAMPAIGN  Specify campaign name directly
  --count COUNT        Number of NPCs to generate

If no options are specified, it will use the settings in .env to connect to the server and poll the campaigns prompting you to select oee and how many NPCs you wish to create

The characters created by this script have the "random_npc" type. So that you can filter them out easily.

The names for the NPCs are requested from names.drycodes.com while the other details are randomly chosen from the JSONs found in the data folder.

Feel free to add stuff to them OR use your own JSONs by pointing the DATA_PATH env variable to their location (make sure that they are named like the ones in the data folder tho!).

If by any chance you want to update and/or enrich the existing JSONs, create a PR.

Have a great time!