Ravenswood Archive Stacks

A community-owned, content-addressed archive of Blood on the Clocktower scripts. Any BotC script site can contribute scripts here, ensuring no scripts are lost if any single service goes down.

How It Works

• Each script is stored as a standard BotC JSON file in scripts/
• Filenames are the MD5 hash of the file contents (content-addressed = automatic de-duplication)
• Scripts are pure BotC JSON - usable directly in any BotC tool (botc.app, etc.)
• index.json provides a searchable index of all scripts with name, author, and source info

Using the Archive

Download everything

git clone https://github.com/Dan-314/ravenswood-archive-stacks.git

Browse the index

index.json contains metadata for every script:

[
  {
    "hash": "abc123...",
    "name": "Trouble Brewing",
    "author": "Steven Medway",
    "character_count": 25,
    "sources": ["ravenswoodarchive"]
  }
]

Use a single script

Each file in scripts/ is a standard BotC script JSON array. Download any scripts/{hash}.json and import it directly into your favourite BotC tool.

Contributing Scripts

See CONTRIBUTING.md for full details. Three ways to contribute:

1. Automated sync — Expose an export API, register as a source, and scripts sync daily via GitHub Action
2. Pull request — Add script files to scripts/ and update your sources/{site}.json manifest
3. Direct push — For trusted, high-frequency contributors with deploy key access

Structure

scripts/           Raw BotC script JSON files, named by content hash
sources/           Source manifests — which scripts came from which site
schema/            JSON Schema for BotC script validation
index.json         Auto-generated searchable index

License

CC0 1.0 - public domain. See LICENSE.

The CC0 waiver applies to the repository structure, index files, tooling, documentation, and any original contributions made to this archive. It does not - and cannot - override or waive rights held by third parties. In particular:

• Blood on the Clocktower is created and owned by The Pandemonium Institute. All trademarks, character names, game mechanics, and related intellectual property remain theirs.
• Script authors retain whatever rights they hold in their creative work (e.g. the selection and arrangement of characters, flavour text, or original homebrew content). Inclusion in this archive does not transfer those rights.

In short, the CC0 dedication covers only the rights that the contributors to this repository actually hold. Everything else belongs to its respective owners.