Skip to content

A small server that helps to keep track of story lines and characters (NPCs) in my pen & paper game. The underlying data is collaboratively maintained in google sheets.

License

MIT, MIT licenses found

Licenses found

MIT
LICENSE.txt
MIT
vis_js_license.txt
Notifications You must be signed in to change notification settings

klieret/ppserver

ppserver

pre-commit.ci status PR welcome Black License

ppserver is a small flask server that helps to keep track of story lines and characters (NPCs) in my pen & paper game. The underlying data is collaboratively maintained in google sheets.

Video

video screenshot

Setup

Installing this package

Clone the repository and run

pip3 install -e .

Data you need

ppserver works of two separate google sheets:

characters

This table lists all characters in your adventures. It should have the following columns:

  1. Name
  2. Description
  3. Race
  4. Appeared (date of first appearance)
  5. Locations (comma separated if more than one location)
  6. Keywords (comma separated if more than one)

The following keywords are allowed:

  • player (this is not a NPC but a player character)
  • dead (character is deceased)

relations

This table lists the relationships between characters. It should have the following columns:

  1. Actor (who is the relationship originating from)
  2. Relation (what is the relation)
  3. Target (target of the the relation)
  4. Extra (additional keywords, comma separated if more than one)

The following keywords are allowed:

  • bi (draw a bidirectional arrow rather than a normal arrow pointing from actor to target)

Google API

Follow these instructions. This involves two steps:

  • Creating the certificate json file and downloading it to your computer
  • Sharing the google sheets with the email address from your service account

Config file

Place the following file at ~/.ppserver.yaml:

# "share with edit rights" link to the characters sheet
character_sheet_link: https://docs.google.com/spreadsheets/d/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/edit?usp=sharing
# file name of this sheet in your google drive
character_sheet_name: characters
# "share with edit rights" link to the relations sheet
relations_sheet_link: https://docs.google.com/spreadsheets/d/XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX/edit?usp=sharing
# file name of this sheet in your google drive
relations_sheet_name: relations
# path to your certificate file
certificate_path: /home/X/Y/Z/pen-and-paper-xxxxxx-yyyyyyyyyyyy.json

License

MIT license License.

This repository contains vis-network.min.js from the vis-network project. Its MIT license is tracked as vis_js_license.txt.

About

A small server that helps to keep track of story lines and characters (NPCs) in my pen & paper game. The underlying data is collaboratively maintained in google sheets.

Topics

Resources

License

MIT, MIT licenses found

Licenses found

MIT
LICENSE.txt
MIT
vis_js_license.txt

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published