Creating a game through the app has 3 main components:
-
You have two options for moderation during the game. If the moderator isn't playing, you can choose the Dedicated Moderator option. Dedicated Moderators are not dealt into the game. Once they start the game, they will know @@ -68,7 +68,7 @@ or to a spectator. That way, if the current Dedicated Moderator has to leave, or simply does not want to moderate anymore, they can easily delegate.
-
There is a role box on this page that includes a list of Default Roles and a list of Custom Roles, which can be displayed by selecting the appropriate button within the box. @@ -79,7 +79,7 @@
Here I add 3 villagers to the game, and then remove them:
-
+
You can add, edit, and remove Custom Roles. You can also import and export them via a formatted text file. Click the hamburger menu on the role box to see the import/export options. Here I create a new Custom Role and observe @@ -87,7 +87,7 @@
-
If you don't fill in these fields, the game will be untimed. If you do, you can use a time between 1 minute and 5 hours. The timer can be played and paused by the current moderator. Importantly, when the timer expires, @@ -96,7 +96,7 @@
-
Step One: Choosing a method of moderation
+- Step One: Choosing a method of moderation
You have two options for moderation during the game. If the moderator isn't playing, you can choose the Dedicated Moderator option. Dedicated Moderators are not dealt into the game. Once they start the game, they will know @@ -68,7 +68,7 @@ or to a spectator. That way, if the current Dedicated Moderator has to leave, or simply does not want to moderate anymore, they can easily delegate.
-
Step Two: Build your deck
+- Step Two: Build your deck
There is a role box on this page that includes a list of Default Roles and a list of Custom Roles, which can be displayed by selecting the appropriate button within the box. @@ -79,7 +79,7 @@
Here I add 3 villagers to the game, and then remove them:
-
+
You can add, edit, and remove Custom Roles. You can also import and export them via a formatted text file. Click the hamburger menu on the role box to see the import/export options. Here I create a new Custom Role and observe @@ -87,7 +87,7 @@
-
Step Three: Set an optional timer
+- Step Three: Set an optional timer
If you don't fill in these fields, the game will be untimed. If you do, you can use a time between 1 minute and 5 hours. The timer can be played and paused by the current moderator. Importantly, when the timer expires, @@ -96,7 +96,7 @@
Being the Moderator
-
In the Lobby, moderators can manage the people in the room and the cards in the game. By clicking the three vertical dots (AKA the "kebab menu") next to a given player (point A @@ -107,9 +107,9 @@ Saving any changes to the roles may affect the player count. If you wish to start the game (point B), the number of Players in the Lobby must equal the number of cards in the game.
-
+
-
Dedicated Moderators can see who is on which team and who is which role. The moderator Kills and Reveals players (Point A below). They are separate actions. So, if you @@ -120,33 +120,33 @@ play and pause the Timer (Point B), and can end the game (revealing everyone's role) or return the game to the Lobby (Point C), where it can be started anew with different settings.
-
+
Similarly, the Temporary Moderator view looks like the below image. They have much the same abilities as a dedicated moderator, except they don't know role or alignment information and cannot transfer their powers. Their powers will be transferred automatically to the first person they remove from the game (which can be themselves).
-
+
-
You can transfer your moderator abilities to anyone that has been removed from the game, or to anyone that happens to be spectating. Here we select a killed player and transfer our powers to them:
-
+
In the Lobby
+- In the Lobby
In the Lobby, moderators can manage the people in the room and the cards in the game. By clicking the three vertical dots (AKA the "kebab menu") next to a given player (point A @@ -107,9 +107,9 @@ Saving any changes to the roles may affect the player count. If you wish to start the game (point B), the number of Players in the Lobby must equal the number of cards in the game.
-
+
-
During the Game
+- During the Game
Dedicated Moderators can see who is on which team and who is which role. The moderator Kills and Reveals players (Point A below). They are separate actions. So, if you @@ -120,33 +120,33 @@ play and pause the Timer (Point B), and can end the game (revealing everyone's role) or return the game to the Lobby (Point C), where it can be started anew with different settings.
-
+
Similarly, the Temporary Moderator view looks like the below image. They have much the same abilities as a dedicated moderator, except they don't know role or alignment information and cannot transfer their powers. Their powers will be transferred automatically to the first person they remove from the game (which can be themselves).
-
+
-
Transferring your moderator powers
+- Transferring your moderator powers
You can transfer your moderator abilities to anyone that has been removed from the game, or to anyone that happens to be spectating. Here we select a killed player and transfer our powers to them:
-
+
Being a Player
- This is an example of what a Player is seeing. The timer is running, and they view their
- role by double-clicking it:
+ This is an example of what a Player is seeing, including the running timer,
+ their role card, and the player list. You can also edit your name for the Room by clicking the pencil next to it.
+ Below, we flip our role card up and down by double-clicking it, and then we bring up the prompt to edit our name:
-
+
- There are three main things - the Timer, your Role Card - and the Player List. Players can view the timer, but only the current moderator can play and pause it. - Your role card starts flipped over - this is useful if you are in-person and don't want someone else accidentally seeing your role as + Players can view the timer, but only the current moderator can play and pause it. Your role card starts flipped over + - this is useful if you are in-person and don't want someone else accidentally seeing your role as it is dealt. You can view your role at any time by double-clicking/double-tapping it. Requiring a double-click guards against the possibility of accidentally flipping your role when tapping other things. Within the Player List, you can see who is alive or dead and who has had their role revealed. There is also a role info button that, diff --git a/server/modules/ServerTimer.js b/server/modules/ServerTimer.js index 8d6b69e..6b87204 100644 --- a/server/modules/ServerTimer.js +++ b/server/modules/ServerTimer.js @@ -7,25 +7,23 @@ This timer is accurate to within a few ms for any amount of time provided. */ function stepFn (serverTimerInstance, expected) { - const now = Date.now(); // - serverTimerInstance.currentTimeInMillis = serverTimerInstance.totalTime - (now - serverTimerInstance.start); - if (now - serverTimerInstance.start >= serverTimerInstance.totalTime) { // check if the time has elapsed + serverTimerInstance.currentTimeInMillis = serverTimerInstance.totalTime - (Date.now() - serverTimerInstance.start); + if (Date.now() - serverTimerInstance.start >= serverTimerInstance.totalTime) { // check if the time has elapsed serverTimerInstance.logger.debug( - 'ELAPSED: ' + (now - serverTimerInstance.start) + 'ms (~' + - (Math.abs(serverTimerInstance.totalTime - (now - serverTimerInstance.start)) / serverTimerInstance.totalTime).toFixed(3) + '% error).' + 'ELAPSED: ' + (Date.now() - serverTimerInstance.start) + 'ms (~' + + (Math.abs(serverTimerInstance.totalTime - (Date.now() - serverTimerInstance.start)) / serverTimerInstance.totalTime).toFixed(3) + '% error).' ); serverTimerInstance.timesUpResolver(); // this is a reference to the callback defined in the construction of the promise in runTimer() clearTimeout(serverTimerInstance.ticking); return; } - const delta = now - expected; expected += serverTimerInstance.interval; serverTimerInstance.ticking = setTimeout(function () { stepFn( serverTimerInstance, expected ); - }, Math.max(0, serverTimerInstance.interval - delta)); // take into account drift + }, Math.max(0, serverTimerInstance.interval - (Date.now() - expected))); // take into account drift } class ServerTimer {
-
+
- There are three main things - the Timer, your Role Card - and the Player List. Players can view the timer, but only the current moderator can play and pause it. - Your role card starts flipped over - this is useful if you are in-person and don't want someone else accidentally seeing your role as + Players can view the timer, but only the current moderator can play and pause it. Your role card starts flipped over + - this is useful if you are in-person and don't want someone else accidentally seeing your role as it is dealt. You can view your role at any time by double-clicking/double-tapping it. Requiring a double-click guards against the possibility of accidentally flipping your role when tapping other things. Within the Player List, you can see who is alive or dead and who has had their role revealed. There is also a role info button that, diff --git a/server/modules/ServerTimer.js b/server/modules/ServerTimer.js index 8d6b69e..6b87204 100644 --- a/server/modules/ServerTimer.js +++ b/server/modules/ServerTimer.js @@ -7,25 +7,23 @@ This timer is accurate to within a few ms for any amount of time provided. */ function stepFn (serverTimerInstance, expected) { - const now = Date.now(); // - serverTimerInstance.currentTimeInMillis = serverTimerInstance.totalTime - (now - serverTimerInstance.start); - if (now - serverTimerInstance.start >= serverTimerInstance.totalTime) { // check if the time has elapsed + serverTimerInstance.currentTimeInMillis = serverTimerInstance.totalTime - (Date.now() - serverTimerInstance.start); + if (Date.now() - serverTimerInstance.start >= serverTimerInstance.totalTime) { // check if the time has elapsed serverTimerInstance.logger.debug( - 'ELAPSED: ' + (now - serverTimerInstance.start) + 'ms (~' + - (Math.abs(serverTimerInstance.totalTime - (now - serverTimerInstance.start)) / serverTimerInstance.totalTime).toFixed(3) + '% error).' + 'ELAPSED: ' + (Date.now() - serverTimerInstance.start) + 'ms (~' + + (Math.abs(serverTimerInstance.totalTime - (Date.now() - serverTimerInstance.start)) / serverTimerInstance.totalTime).toFixed(3) + '% error).' ); serverTimerInstance.timesUpResolver(); // this is a reference to the callback defined in the construction of the promise in runTimer() clearTimeout(serverTimerInstance.ticking); return; } - const delta = now - expected; expected += serverTimerInstance.interval; serverTimerInstance.ticking = setTimeout(function () { stepFn( serverTimerInstance, expected ); - }, Math.max(0, serverTimerInstance.interval - delta)); // take into account drift + }, Math.max(0, serverTimerInstance.interval - (Date.now() - expected))); // take into account drift } class ServerTimer {