bra1n / townsquare

Blood on the Clocktower virtual grimoire & town square

Hi there 👋

townsquare's Issues

Bug: custom role reminders can't be assigned to a player due to missing icons

Demon bluffs not saved on reload

Noticed this last night - the rest of the state was saved except for the Demon's three bluffs.

Bug: Custom script characters are sorted by set instead of by script order

Bug: session player count stuck at 1 even for more players

Feature Request: Add a Drunk reminder token when the Drunk isn't in play

Is your feature request related to a problem? Please describe.
In Trouble Brewing, currently the only time the Drunk reminder token appears is when the Drunk is in play. The Drunk reminder token is for reminding the Storyteller which Townsfolk role is drunk. At the moment, the only way is to add a custom token that says Drunk to reminder you as the storyteller.

Describe the solution you'd like
The Drunk reminder token to be available when the Drunk isn't in play.

Describe alternatives you've considered
Role reminder tokens for the Drunk character token, but that's a lot more tokens and not how it works in the real Grimoire. In that, the players are given the Townsfolk role token and then there Storyteller puts the Drunk reminder token. There is no "Drunk" character token.

Additional context

Hover effect for role selection in the Grimoire

It would be great to have an effect when you hover over a role circle in the Grimoire, to help you notice that there IS an invisible button that lets you select a player's role. There is one for the shroud's invisible button and that helps STs know that there is a button there and what it does, so one for role selection would be great.

I think a simple white, semi-transparent circle over the role token would suffice.

Screenshots not working on Firefox

As mentioned in #6 , screenshots do not work when using Firefox.

... Though maybe it'd be fine if you only supported Chrome. Switching browsers isn't too difficult :)

Screenshot inconsistencies

I'm having some trouble with the screenshot feature - though feel free to delete my issue if I misunderstood how to use it 🎉

• Screenshots do not work on Firefox (nothing is copied to the clipboard)
• Screenshots for individual characters seem to be cropped incorrectly
  • 

Feature Request: Night Order

It is helpful for players to know the night order, for example to help with bluffs or to help catch people in bluffs. It would be very useful to have an option to bring up the night order, similar to bringing up the Reference Sheet by pressing R.

A couple of ideas I had for this are:

• Add tabs to the existing Reference Sheet for night 1 order and subsequent nights order.
• Add a new modal with two tabs, one for each order
• Add two new modals, one for each order

Cheers,

J

First night evil info

It would be nice to have first night reminders for the "Minion info", "Demon Info", & "Demon Bluffs" on the Night Order sheet and/or the on-token reminders. These would be the reminders for "who is your demon", "who are your minions", and "what you can bluff as the Demon", respectively.

Having reminders on the token themselves would definitely be better, and I'd imagine them labeled as number 0, but you'd have to resolve the problem of roles that can act on the first night, which would then need 2 separate reminders. You could merge both reminders into one text box but you'd need the order numbers for both to appear in the circle (so the Spy for example would have a reminder circle that reads "0, 2" or something). Or you could code it to display 2 separate circles that each have their own hovers with their own tooltips. It's more work, but it's clearest.

Otherwise, only showing those on the Night Order sheet would, imo, be a fine compromise, since that should be pretty easy to implement.

You cannot unassign a traveller role from a character

If you've joined a session and set a character to be a traveller, you can't unassign the role from them. Obviously in the normal use case you know they're a traveller but if you misclick assigning a role to someone and select a traveller then they're just as that until you leave the session and gain the ability to remove characters.

Feature Request: Support Toy Maker

Is your feature request related to a problem? Please describe.
Better support for https://bloodontheclocktower.com/wiki/Toymaker games. Doesn't have to be general Fabled support. Right now 5/6 player games auto-hide the Demon bluffs and I can't see a way to get them back without adding more players.

Describe the solution you'd like

• Ability to leave the demon bluffs on in 5-6 player games
• Reminder token for demon has skipped their kill (optional, since a custom note works fine.)

Describe alternatives you've considered
If there is a way to get the bluffs to show in 5-6 player games and I missed it, my apologies.

p.s. Thank you very much for making this tool!

Bug: adding / moving a player in a live session will offset assigned spectator roles

Feature Request: Show your own role in your "personal" Grimoire

It would be nice if the Grimoire that you can show for yourself had your role above your name. It would clarify what that screen is for immediately and would save time during setup by not making the Storyteller tell everyone manually what each player's role is in a DM. Ideally, you could still replace it with other stuff in case you think you're actually a Drunk or a Lunatic (but then it should also let you "reset" to the role that was shown to you)

Feature Request: Keep Night order tokens for Dead players

Is your feature request related to a problem? Please describe.
Situation occured in the Live Stream
where the Moonchild was killed during the day, selected someone to die, but they were protected by the Innkeeper. This is the correct night order (Innkeeper comes before Moonchild death) but it's difficult as the ST to see this because the Moonchild night order is removed when they die. This also happens for minions killed by the Vigormortis, they still have their night order position removed, even if you give them the Vigo reminder token that their still active, they don't get a night order.

Describe the solution you'd like
Night order remains intact for dead players (perhaps grey them out to indicate they are dead)

Describe alternatives you've considered
This perhaps could only be applied to particular night roles where they have an impact while dead e.g. Moonchild and when minions have active ability tokens but I feel it's easier to just have all roles when dead have their night order.

Additional context

In this instance, the Cerenovus should still be 1 in the night order because they have an active ability but they don't have their night order displayed.

Feature Request: rename master

Is your feature request related to a problem? Please describe.
In society at large we are facing a reckoning about how we use racially termed language. I love the BotC community and how we are so open to issues and lie to each other so much, but are generally a great group. I work in tech and there has been a big push to move from master/slave, whitelist/blacklist, and other 'legacy' terms and I think changing the name of master to 'main' would be a good step in the right direction.

Describe the solution you'd like
Update master to main or trunk

Describe alternatives you've considered
n/a

Additional context
https://www.lifehacker.com.au/2020/06/ditch-these-racist-terms-from-your-tech-vocabulary/

Feature Request: Ability to display Grimoire to Players

It would be a nice feature to be able to display the Grimoire to all players at the end of the game for the run-through, As an extension of this being able to allow a spy to view the grimoire at the right time.

Bug: If a player joins while a vote is occurring the hands go wonky

Describe the bug
The hands of the vote clock goes crazy if someone joins the player session while a vote is occurring. This is for everyone, not just the person joining.

To Reproduce
Steps to reproduce the behavior:

1. Storyteller starts a vote
2. A player joins the session while the vote is occurring.

Expected behavior
The vote should just continue without resetting and going weird.

Desktop (please complete the following information):

• OS: Windows 10
• Browser: Firefox
• Version: 78.0.2 (64-bit)

Feature request: Tooltips in the center of the screen

I mostly use the app in vertical windows, because between the app, the reference sheet of the original game, and the Discord window, I have to split my screen to see everything at once. One problem that often shows up is that certain popups show outside of the screen, and the role/night tooltips are the biggest offenders since they show up on the sides of the role tokens.

To fix this, I think it'd be really good to have those tooltips show up in a box right in the middle of the screen. It'd be centered and nice looking, and it wouldn't risk going off-screen since it would dead center. It would also maybe make the tool usable on mobile, tho that's not the goal of this feature, so not something to really consider or test for.

Feature Request: Allow players to assign multiple roles and/or generic Demon/Minion

As a player it's quite useful to track information in the grimoire but you're forced to assign one role to a player or to assign Demon/Minion to someone since you might not know which Minion/Demon there was.

Zoom does not work on Firefox 76.0

The player tokens cannot be zoomed when using Firefox.

Though zooming the entire web page with CTRL and + or - works.

Bug: Joining an in-progress nomination as a player will reset all votes

ST should sync current vote state for live nominations when a player joins

Feature Request: Make Demon Bluff window display on top of the roles

The Demon Bluff window can be overlaid by the roles in vertically shaped browser windows.

I think you should make IT overlay the roles instead. That way it's fine if it covers up the roles since we can close that window again anyway

Example of the problem (I'm trying to close the Demon Bluff window):

Bug: "Finishing" a vote in progress will not cancel the timer

Also it looks like vote messages are sent twice when clicked very often.

Remove underscores from exported custom scripts

The Script Tool exports scripts with underscores in role names, e.g. scarlet_woman. This doesn't work when importing the script into the town square.

Feature Request: Hotkey for night order

As it stands there is no hotkey to show the night order. Please can you add a hotkey to show the night order screen?

This could either be a new hotkey (eg n for night) or changing r to cycle between role sheet, night order and hidden. I suspect a new hotkey would probably be best practice to avoid confusing people who already use r to toggle the role sheet on and off.

Text boxes sometimes blurry

In Chrome and Firefox:

• Some text boxes for characters descriptions are blurry.

Normal text box:

Blurry text box:

Firefox only:

• Names are sometimes blurry
• First night / other night texts blurry and aliased

Feature Request: Open the "Night Order" screen using [R] if previously viewed using the toggle

Is your feature request related to a problem? Please describe.
Observation: After pressing the hotkey [R] you must always mouse-click the upper-left toggle to view the Night Order sheet each time.

Current behavior:
When clicking on the Reference Sheet menu item, or using the hot-key [R], the "Character Reference" is displayed first.

If you toggle the screen to show the "Night Order", this is not remembered if the window is close & later re-opened.

Describe the solution you'd like
I suggest that if a user has toggled the "Character Reference" to "Night Order" that is remembered for that session.

Using [R] would therefore open the Night Order if that what they used last time, or Character Reference of that's the case.

Describe alternatives you've considered
I am aware the Night Order is presented on the Character Tokens (numbers) which is great, but I personally find reading the sequenced Night Sheet easier - by allowing this Night Order to be quickly viewed with [R], I think the experience is improved.

Additional context
Perhaps a separate request, but can the Night Order sheet be filtered to only show Characters in play? This would be an excellent addition!

Bug: Votes displayed incorrectly

There have been several times I have seen the issue, and glancing at the code it seems that it is just a failure to account for inherent network lag. Essentially the problem is that if a vote is submitted at the last second on client side, the client can register that they voted yes, but other players see a No (or vice-versa.)

Reproduce steps (not consistent pointing toward network latency even more):

1. Start execution vote.
2. Begin votes.
3. Right before the clock hand locks in, switch your vote.
4. If the bug occurs, there should be a desync between clients.
   (May want to test with fake latency injection code to identify)

Fix: I would suggest a handshake system or server side grace period that favors the voter so even if there is a slight desync it should update the vote on the other clients before the next person votes while not confusing the voter.

Good Luck,
Duckheady

Clarify "number of votes required for execution" text on voting screen

On any votes after the first in a game day, the number of votes required to succeed is incorrectly shown based on previous successful votes. It curently always shows the number purely based on the number of alive players.

Shortcut keys do not work when using caps lock

If you have caps lock on and press G, nothing happens.

All travelers selectable

It would be great to have the option to select all Travelers regardless of the edition/script selected, since choosing any Traveler you want is a

The easy way for you to implement this is adding the roles to the list of roles for each edition.
The BETTER way to do it imo would be to have a 2nd screen which lets us select Travelers from the whole list of Travelers. I imagine a button called "Travelers" that rotates the menu, like the button that rotates between the Reference sheet and the Night Order sheet (tho, imo, the button itself should read "Travelers" instead of having a little symbol like the Night Order sheet button does)

Character selection screen: Display name instead of number

(This is a suggestion)
The character selection screen currently displays the player's number instead of their name.

It would probably be easier to see what player you're assigning if their name was visible on this screen, too.

Setting a background URL does not persist

If you customise the background image using a URL, and then select a new background image the box will be blank and pressing cancel removes the current image (returning you to the original background image)

Feature Request: Add Seat Indicators

Is your feature request related to a problem? Please describe.

We had a great time in a big 14-player game! However, communicating how the site works to that many people at once is tricky, and a few got confused how to claim their seat. There were also a few occurrences of people reconnecting and inadvertently vacating their seat (I think at least once they somehow refreshed as a host). It wasn't obvious to us when a seat was properly filled or not.

Describe the solution you'd like

An extra visual element to indicate a seat's status would help marshal a big game. Maybe empty seats could have a brightly-colored button on or nearby to claim them, instead of having to use the context menu? Or be grayed- or "X"ed-out somehow? If it's possible, each player's view could also have a thick outline around their current seat.

A clearer separation between the host and player version of the page could help, too. Maybe a different background?

Describe alternatives you've considered
A status bar or banner across the top could probably work, too ("You are playing as XXX", "You are hosting game xxxx").

Change window title when in town square mode vs grimoire mode

This would make it easier to pick the correct tab to enable streaming

Bug: Night sheet button in reference sheet not doing anything

For me the little night sheet button in the top left of the reference sheet isn't doing anything

(I just double clicked it and it selected the text to the right)

[BUG] Demon bluffs can't be set in a live session (as spectator)

Feature Request: Changing the name of the "Grimoire" tab to "Town Square" for the players

Currently, the first tab is called Grimoire but for the players that doesn't really reflect what that tab does. I think it should be renamed to "Town Square" and the first button should read "Show Notes" instead of just "Show".

The Night order button could also MAYBE be hidden for the players? they don't NEED that info (plus if they have a vague sense of who the Storyteller might be talking to it's actually a problem) and it's always good to remove extra stuff from menus.

Bug: Rooms starting with an upper case letter are not displayed

Describe the bug
If you create a room with a word, and start with an upper case letter, it is not displayed.

To Reproduce

1. Create a room named Ellen
2. View the room name, it is listed as llen
3. The room however is actually named Ellen

Expected behavior
The room should be displayed as Ellen

Screenshots

Desktop (please complete the following information):
Multiple people have said this occurs for them so pretty sure OS/Browser/Version is irrelevant.

Allow custom editions with custom characters

Love your tool - this is awesome. But in recent months our game play has evolved and we have created quite a few custom scripts.

I was wondering if your tool can be extended to add custom roles ? (ie edit names on some generic tokens when set is 'custom'). Thanks!

Bug: votes can be cast after the lock when there is high latency

After the storyteller locks a vote but before the lock is received by a player, that player may change their vote and cause a race condition for other players, depending on which messages arrives first - the lock or the vote.

Feature Request: Minimizing Demon bluffs

It would be great if we could minimize the Demon bluffs when viewing the Grimoire. When the screen is tight horizontally (like if it's displayed over half your screen) the Demon bluff window tends to overlap the roles.

Also, it's not really a useful feature for the players to have, so it should be minimized for them from the start

Feature Request: Adjustable voting clock speed

It would be really great to be able to set the speed of the clock. Ideally, there would be a number that shows you how many seconds it will take to reach each successive players (and the total that would make when multiplied by the number of players)

Feature Request: Flipping menus/tooltips that appear outside the screen

When you have your window scaled in a more vertical manner (like if it's split over half your screen) then some menus or tooltips can appear outside of the screen. Clicking the name of the players on the right means you don't see the entire (or any) of the menu that appears there. And this can also happen both on the right AND left for the Grimoire tooltips (either for role description or night order tooltips)

Having menus/tooltips appear on the other side if they're from the more side-located roles would fix this issue

Bug: You can "Prevent this page from opening additional dialogues" which breaks adding/randomising players

Describe the bug
There appear to be 2 kinds of "Add Player" diaglogue boxes.

If you select the box to "Prevent this page from opening additional dialogues" then you can no longer add any other players (because the dialogue box is prevented).

To Reproduce
Steps to reproduce the behavior:

1. Refresh the page
2. Add a player (this produces the first pictured dialogue box). Cancel.
3. Add a player (this produces the second pictured dialogue box). Check the box to prevent additional dialogue boxes.
4. Add a player (either through the menu or using the shortcut).Nothing happens.

Expected behavior
You should either:

1. Not be allowed to "Prevent this page from opening additional dialogue boxes"
2. Allow players to be added even if dialogue boxes are prevented.

Screenshots
and

Desktop (please complete the following information):

• OS: Windows 10
• Browser: Firefox 77.0.1

Feature Request: Game State Export

Is your feature request related to a problem? Please describe.
I'm trying to build a BotC stats site (for the time being just for my local group) to track win/losses, characters played etc. My initial design is quite laborious in terms of uploading the game state since you need to enter every player and character (as well as Demon bluffs etc). I think pretty much all of the game information is available in this online Grimoire and I'm wondering if the game information could be exported in a known data format that could be imported into a stats database

Describe the solution you'd like
The ability to export and download/view a JSON file containing the

• Players in the game (WIBNI if it included position in the circle)
• Role of each player
• Death state of each player
• Demon Bluffs
• The script played (preferably as a JSON document)
• WIBNI Alignment of each player

Describe alternatives you've considered

• Seeing as no information is stored in any central server an API query is out.
• I'm not planning on making my stats engine highly available so I think correspondingly a POST request rather than download is out.

Additional context
None

Bug: image property is mandatory in custom characters

README images

Feature Request: Add pronoun flags

Is your feature request related to a problem? Please describe.
There are many players in the community that sound different to the pronouns they prefer. I would love to have a way for my players to, when they take the seat, be able to highlight their preferred pronouns. she/her they/them he/him

Describe the solution you'd like
The storyteller sets up the grimoire with who is playing with their names. When players log in to session and choose their seat, they have the option to select a pronoun flag that appears under their name.

Describe alternatives you've considered
As a storyteller we can always add this to their player names, but when playing with new friends we might not always know what pronouns they prefer to type them in. This would allow the players themselves to have control over the sharing of this information.

Additional context
n/a