mirror of
https://github.com/Dan-314/ravenswood-archive-stacks.git
synced 2026-05-18 08:04:04 -05:00
2.1 KiB
2.1 KiB
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 dedup)
- Scripts are pure BotC JSON — usable directly in any BotC tool (clocktower.online, etc.)
index.jsonprovides 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 Modified",
"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:
- Automated sync — Expose an export API, register as a source, and scripts sync daily via GitHub Action
- Pull request — Add script files to
scripts/and update yoursources/{site}.jsonmanifest - 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.
Blood on the Clocktower is created and owned by The Pandemonium Institute.