No description
Find a file
2026-05-08 11:28:58 +02:00
scripts feat: changed typo 2026-05-08 11:28:58 +02:00
build_script.py feat: Improve build script to skip existing JSON files and handle multiple editions 2026-04-12 13:16:25 +02:00
README.md Update README.md 2026-05-03 18:26:30 +02:00
roles.json feat: add python script to build sheettokens from roles 2026-04-09 08:26:33 +02:00

Blood on the Clocktower

A small repository for generating edition-specific role scripts from a single master role dataset.

Repository structure

  • roles.json
    • Canonical role dataset.
    • Includes metadata and all character definitions across editions.
  • build_script.py
    • Reads roles.json and writes edition JSON files under scripts/.
    • Builds each edition's image URLs and injects an _meta entry.
  • scripts/
    • Contains edition-specific folders and generated JSON files.
    • Example editions: Trouble Brewing, Bad Moon Rising, Carousel, Sects & Violets, Experimental Edition, Fabled, Loric.

How it works

  1. build_script.py loads roles.json.
  2. It groups roles by edition.
  3. It prefixes each edition output with metadata:
    • id: "_meta"
    • name
    • author
  4. It creates an image URL for each role using the edition and role ID.
  5. Each generated file is written to scripts/<Edition Name>/<Edition Name>.json.

Running the generator

From the repository root:

python .\build_script.py

This regenerates any missing edition files under scripts/.

Data format

Each edition JSON file is an array. The first element is metadata, followed by role objects with fields like:

  • id
  • name
  • edition
  • team
  • ability
  • flavor
  • reminders
  • firstNightReminder
  • image