# thepandemoniuminstitute/botc-release architecture

> Architecture diagram of the GitHub repository thepandemoniuminstitute/botc-release, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/thepandemoniuminstitute/botc-release
- Repository: https://github.com/thepandemoniuminstitute/botc-release

## Overview

This repository is a release-download landing site and a collection of Blood on the Clocktower toolmaker assets and script data; it does not contain the app itself. The documented user path is to find an app download, or for toolmakers to use the published resources and script schema. The sampled plugins show Jekyll-side directory and character-icon rendering, including the icon data lookup. The app-download page and several content-rendering relationships are not sampled, so those links are limited to README evidence.

Main entry points: [`_plugins/icons_tag.rb`](https://github.com/thepandemoniuminstitute/botc-release/blob/main/_plugins/icons_tag.rb) (Character icon tag), [`README.md`](https://github.com/thepandemoniuminstitute/botc-release/blob/main/README.md) (App downloads), [`resources/index.md`](https://github.com/thepandemoniuminstitute/botc-release/blob/main/resources/index.md) (Published resources), [`_plugins/directory_tag.rb`](https://github.com/thepandemoniuminstitute/botc-release/blob/main/_plugins/directory_tag.rb) (Directory tag)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_site["Site rendering"]
  node_app_downloads["App downloads<br/>[README.md]"]
  node_resource_site["Published resources<br/>[index.md]"]
  node_directory_tag["Directory tag<br/>[directory_tag.rb]"]
  node_icons_tag["Character icon tag<br/>[icons_tag.rb]"]
end

subgraph group_resources["Toolmaker resources"]
  node_character_icons["Character icons"]
  node_role_data["Role definitions<br/>[roles.json]"]
  node_night_data["Night sheet data<br/>[nightsheet.json]"]
  node_jinx_data["Jinx data<br/>[jinxes.json]"]
  node_editions["Edition assets"]
  node_community_assets["Community assets"]
end

subgraph group_scripts["Script content"]
  node_script_schema["Script JSON schema<br/>[script-schema.json]"]
  node_wc25_catalog["WC25 catalog<br/>[data.json]"]
  node_wc25_scripts["WC25 scripts"]
end

node_visitor(("App user"))
node_toolmaker(("Toolmaker"))
node_homebrew_author(("Homebrew author"))

node_visitor -->|"finds downloads"| node_app_downloads
node_toolmaker -->|"uses assets"| node_resource_site
node_homebrew_author -->|"validates scripts"| node_script_schema
node_homebrew_author -->|"adds metadata"| node_app_downloads
node_icons_tag -->|"reads roles"| node_role_data
node_icons_tag -->|"scans icons"| node_character_icons
node_directory_tag -.->|"iterates directories"| node_resource_site

click node_app_downloads "https://github.com/thepandemoniuminstitute/botc-release/blob/main/README.md"
click node_resource_site "https://github.com/thepandemoniuminstitute/botc-release/blob/main/resources/index.md"
click node_directory_tag "https://github.com/thepandemoniuminstitute/botc-release/blob/main/_plugins/directory_tag.rb"
click node_icons_tag "https://github.com/thepandemoniuminstitute/botc-release/blob/main/_plugins/icons_tag.rb"
click node_character_icons "https://github.com/thepandemoniuminstitute/botc-release/tree/main/resources/characters"
click node_role_data "https://github.com/thepandemoniuminstitute/botc-release/blob/main/resources/data/roles.json"
click node_night_data "https://github.com/thepandemoniuminstitute/botc-release/blob/main/resources/data/nightsheet.json"
click node_jinx_data "https://github.com/thepandemoniuminstitute/botc-release/blob/main/resources/data/jinxes.json"
click node_editions "https://github.com/thepandemoniuminstitute/botc-release/tree/main/resources/editions"
click node_community_assets "https://github.com/thepandemoniuminstitute/botc-release/tree/main/resources/community"
click node_script_schema "https://github.com/thepandemoniuminstitute/botc-release/blob/main/script-schema.json"
click node_wc25_catalog "https://github.com/thepandemoniuminstitute/botc-release/blob/main/wc25/data.json"
click node_wc25_scripts "https://github.com/thepandemoniuminstitute/botc-release/tree/main/wc25"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app_downloads,node_resource_site,node_directory_tag,node_icons_tag,node_visitor toneBlue
class node_character_icons,node_role_data,node_night_data,node_jinx_data,node_editions,node_community_assets toneAmber
class node_script_schema,node_wc25_catalog,node_wc25_scripts toneMint
class node_toolmaker,node_homebrew_author toneIndigo
```

## Components

### Site rendering

- [App downloads](https://github.com/thepandemoniuminstitute/botc-release/blob/main/README.md): `README.md`
- [Published resources](https://github.com/thepandemoniuminstitute/botc-release/blob/main/resources/index.md): `resources/index.md`
- [Directory tag](https://github.com/thepandemoniuminstitute/botc-release/blob/main/_plugins/directory_tag.rb): `_plugins/directory_tag.rb`
- [Character icon tag](https://github.com/thepandemoniuminstitute/botc-release/blob/main/_plugins/icons_tag.rb): `_plugins/icons_tag.rb`

### Toolmaker resources

- [Character icons](https://github.com/thepandemoniuminstitute/botc-release/tree/main/resources/characters): `resources/characters`
- [Role definitions](https://github.com/thepandemoniuminstitute/botc-release/blob/main/resources/data/roles.json): `resources/data/roles.json`
- [Night sheet data](https://github.com/thepandemoniuminstitute/botc-release/blob/main/resources/data/nightsheet.json): `resources/data/nightsheet.json`
- [Jinx data](https://github.com/thepandemoniuminstitute/botc-release/blob/main/resources/data/jinxes.json): `resources/data/jinxes.json`
- [Edition assets](https://github.com/thepandemoniuminstitute/botc-release/tree/main/resources/editions): `resources/editions`
- [Community assets](https://github.com/thepandemoniuminstitute/botc-release/tree/main/resources/community): `resources/community`

### Script content

- [Script JSON schema](https://github.com/thepandemoniuminstitute/botc-release/blob/main/script-schema.json): `script-schema.json`
- [WC25 catalog](https://github.com/thepandemoniuminstitute/botc-release/blob/main/wc25/data.json): `wc25/data.json`
- [WC25 scripts](https://github.com/thepandemoniuminstitute/botc-release/tree/main/wc25): `wc25`

### Other components

- **App user**
- **Toolmaker**
- **Homebrew author**

## Connections

- App user → App downloads: finds downloads (evidence: `README.md`)
- Toolmaker → Published resources: uses assets (evidence: `README.md`)
- Homebrew author → Script JSON schema: validates scripts (evidence: `README.md`)
- Homebrew author → App downloads: adds metadata (evidence: `README.md`)
- Character icon tag → Role definitions: reads roles (evidence: `_plugins/icons_tag.rb`)
- Character icon tag → Character icons: scans icons (evidence: `_plugins/icons_tag.rb`)
- Directory tag → Published resources: iterates directories
