Local copy of the nice blood on the clocktower webapp in case it ever disappears.
Go to file
Steffen a5d6d593c8 show generic icons for custom roles and opt out players 2021-02-04 21:40:59 +01:00
.github Update linter.yml 2021-01-04 20:26:58 +01:00
public remove screenshot feature as it is no longer needed 2020-12-27 20:11:57 +01:00
server optimized ping and gamestate messages 2021-01-29 21:54:27 +01:00
src show generic icons for custom roles and opt out players 2021-02-04 21:40:59 +01:00
.eslintrc.js eslint added 2020-04-05 19:50:33 +02:00
.gitignore added custom socket server 2020-05-27 22:33:51 +02:00
CHANGELOG.md highlight dead players on night order sheet (closes #106) 2021-01-27 21:40:36 +01:00
CNAME server readme and cname added 2020-12-18 21:05:14 +01:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2020-05-24 22:35:28 +02:00
CONTRIBUTING.md linting and details on hosting your own fork 2021-01-09 21:33:09 +01:00
LICENSE Create LICENSE 2020-05-11 23:45:16 +02:00
README.md Update README.md 2020-12-27 21:56:43 +01:00
package-lock.json 2.6.0 2021-01-27 22:04:49 +01:00
package.json 2.6.0 2021-01-27 22:04:49 +01:00
vue.config.js optimized ping and gamestate messages 2021-01-29 21:54:27 +01:00

README.md

Blood on the Clocktower Grimoire & Town Square

social

This is an unofficial online tool to run Blood on the Clocktower games through Discord or other digital means. It is supposed to aid storytellers and allow them to quickly set up and capture game states for their players.

You can try it online!

If you want to learn more about how to use the website as a player, JayBotC kindly created two tutorial videos.

How to host a game

How to host a game

How to play a game

How to play a game

Features

  • Public Town Square and Storyteller Grimoire (toggle with shortcut [G])
  • Supports custom script JSON generated by the Script Tool
  • Live Session for Storyteller / Players including live voting and character distribution!
  • Includes all 3 base editions, Travelers and Fabled
  • Night sheet and reminder text for each character ability to help storytellers
  • Many other customization options!

Custom Script Support

Any custom script generated by the official Script Tool is supported out of the box and you only need to upload it to get the selected set of characters into your grimoire. If you want to customize your script further, there is an additional "_meta" object that you can add to the script like you would add a normal character:

[
  {
    "id": "_meta",
    "name": "Deadly Penance Day",
    "author": "TPI",
    "logo": "https://url.to/your/logo.png"
  }
]

This will provide your local Grimoire (and those of your live session players) with more information to show about your custom script - instead of "Custom Script" it would show "Deadly Penance Day" on the character reference sheet, for example. The logo is shown only locally, if you want your players to see it as well, they will have to upload the same JSON file that you used.

Custom Character Support

In order to add custom characters to your local Grimoire, you need to create a JSON definition for them, similar to what is provided in the roles.json for the 3 base editions. Here's an example of how such a character definition file might be written:

[
  {
    "id": "acrobat",
    "image": "https://github.com/bra1n/townsquare/blob/main/src/assets/icons/acrobat.png?raw=true",
    "edition": "custom",
    "firstNight": 0,
    "firstNightReminder": "",
    "otherNight": 49,
    "otherNightReminder": "If either good living neighbor is drunk or poisoned, the Acrobat dies.",
    "reminders": ["Die"],
    "remindersGlobal": [],
    "setup": false,
    "name": "Acrobat",
    "team": "outsider",
    "ability": "Each night*, if either good living neighbor is drunk or poisoned, you die."
  },
  { 
    "id": "investigator" 
  },
  { 
    "id": "imp" 
  }
]

This definition JSON includes a custom character, the Acrobat, and 2 base game characters, the Investigator and the Imp. For base game characters, it is sufficient to only provide the ID, similar to what you get from the Script Tool.

Required properties: id, name, team, ability

  • id: the internal ID for this character, without spaces or special characters
  • image: a URL to a PNG of the character token icon (should have a transparent background!)
  • edition: the ID of the edition for this character. can be left blank or "custom"
  • firstNight / otherNight: the position that this character acts on the first / other nights, compared to all other characters
  • firstNightReminder / otherNightReminder: reminder text for first / other nights
  • reminders: reminder tokens, should be an empty array [] if none
  • remindersGlobal: global reminder tokens that will always be available, no matter if the character is assigned to a player or not
  • setup: whether this token affects setup (orange leaf), like the Drunk or Baron
  • name: the displayed name of this character
  • team: the team of the character, has to be one of townsfolk, outsider, minion, demon or traveler
  • ability: the displayed ability text of the character

Note: in order to use custom characters in live sessions, your players have to load the same JSON file that the storyteller has loaded before joining the live session.

Code of Conduct

Contributing

Acknowledgements and Copyrights

This project and its website are provided free of charge and not affiliated with The Pandemonium Institute in any way.

Donations

This project will always be available free of charge, since I love building cool things and playing Blood on the Clocktower. If you still want to support me with a donation, you can do that here:

Donate