Download Roles

Fetch official role data from the Blood on the Clocktower script tool and download it as a ZIP of JSON files and icon images.

Script filter

Filters roles whose version field contains this string. Leave blank for all roles.

Use playtest icon source

Fetches icons from the community playtest repository instead of official script-tool image URLs. Useful when official images are unavailable.

What's in the ZIP?

The downloaded archive contains one .json file per role and the corresponding icon image, organised into folders by script edition and team type:

Trouble Brewing/
  Townsfolk/
    washerwoman.json
    Washerwoman.png
    librarian.json
    Librarian.png
    …
  Minion/
  Demon/
Bad Moon Rising/
  …

Next steps

Unzip the archive, then head to Create Tokens and drag the JSON files and icon PNGs into the upload zones. The icon field in each JSON already matches the filename in the same folder.