mirror of
https://github.com/drazicmartin/BOTC.git
synced 2026-11-22 14:38:21 +00:00
No description
- Python 100%
| scripts | ||
| build_script.py | ||
| README.md | ||
| roles.json | ||
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.jsonand writes edition JSON files underscripts/. - Builds each edition's image URLs and injects an
_metaentry.
- Reads
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
build_script.pyloadsroles.json.- It groups roles by
edition. - It prefixes each edition output with metadata:
id: "_meta"nameauthor
- It creates an
imageURL for each role using the edition and role ID. - 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:
idnameeditionteamabilityflavorremindersfirstNightReminderimage
Helpful links
- Token PDF generator: https://botc-tokencrafter.miketilly.com/
- Add 10% margin
- Scale icon to 120%
- Resources: https://release.botc.app/resources/
- Official wiki: https://wiki.bloodontheclocktower.com/Main_Page
- Scripts builder : https://script.bloodontheclocktower.com/
- BOTC tools : https://botc-tools.xyz/
- Books