- Card
- A visual representation of a clue in the context of a game. On a player‘s turn, they draw a card, move it into the right position in their timeline, and submit their guess.
- Category
- A collection of clues. Categories may be public or private, and the owner of the category may invite other users โ called collaborators โ to manage the clues in it.
- Clue
- A description of a specific, unique event. Clues can have hints, additional meta data, reference URLs, and even images. Clues can be associated to multiple categories.
- Collaborator
- A user who has been invited to co-manage a category. Collaborators can add and remove their own clues to a category, but cannot manage the clues of other collaborators or the category owner. Room owners are allowed to start games with any category they either own or for which they are a collaborator.
- Difficulty
- A 1-3 rating of the average historical correct guesses for a clue. If greater than 66.66% of historical guesses were correct for a clue, the clue is considered easy. If less than 33.34% of historical guesses were incorrect for the clue, the clue is considered hard. Any clue with a historical correct guess percentage of between 33.34% and 66.66% is considered medium.
- Game
- An instance of structured play, with a beginning, end, and set number of players as determined by the owner. Players of a game consist of the users who have joined it. The owner of the game sets the game’s options when creating it, including win conditions.
- Guess
- A submission of an active card in a player‘s timeline during their turn. Once a player has drawn a new card, the player must move the card to the place on their timeline where they believe it belongs, then they must submit their guess. The card will become yellow if the guess is correct, or red if the guess is incorrect. They player must lock in their correct guesses by ending their turn. If a player guesses incorrectly, all cards they have guessed during that turn are lost.
- Hint
- Additional information about a clue meant to help the player make a correct guess, without explicitly revealing the answer. Hints may be added to a clue on its “More Info” screen. Whether to show hints to players is a game option that can be toggled by the owner when starting a new game.
- Lobby
- The screen from which users create or join a game. By default, users will end up the lobby once they sign up or log in.
- Lock [Turn]
- The ending of a turn by a player after having guessed one or more cards correctly. In games where players are allowed to guess more than 1 card during their turn, the player has the option of drawing a new card or locking in the cards which they have previously guessed correctly on that same turn. Any cards that are locked are permanently counted toward the player‘s overall card count and cannot subsequently be lost.
- Locked [Clue]
- A clue that only be changed by the owner.
- Open [Clue]
- A clue which the owner has allowed other users to edit, assuming the user has permissions for the category in which it resides.
- Owner
- A user that created a game, category, or clue is considered its owner. Being the owner grants specific privileges that cannot be superseded by other users. Only game owners can start, end, or abandon games. They can also eject players from the game. Category owners can manage the category options and add or remove collaborators. Clue owners can edit or delete the clue and add or remove it from categories for which they are the owner or a collaborator.
- Player
- A user in who has joined a game.
- Precision
- The specificity at which dates and times are compared to one another to determine whether a guess is correct. If 2 cards next to each other have equivalent dates and times based on the precision at which the game is being played, the guess will be considered to be correct โ even if the dates and times of the clues are not equivalent at a greater precision. For example, if the game is being played at a precision of “decade,” then any events which occurred during the 1980s are considered equivalent for the purposes of comparison. A category‘s default precision may be set by the category owner. As a general rule of thumb, the greater the overall timespan of a category, and the less precise the records of events, the lower the game‘s precision should be set.
- Round
- A group of turns in which every player has had 1 chance to guess cards.
- Score
- The sum of all upvotes and downvotes for a clue. During the course of a game, players may upvote or downvote a card after it has been guessed regardless of whether the card appears on their timeline or that of an opponent. Each user may only downvote or upvote a clue once, but they may subsequently change their vote. A clue‘s score therefore represents a crowd-sourced quality assessment by the entire community. The game owner may set a minimum score as a game option, thereby excluding clues with scores that are below the desired threshold.
- Theme
- A broad classification of a category. The owner of a category must select a theme for the category so that game owners can know the general type of clue that the category contains when selecting a category for a game. For example, the “Family” theme is for categories of clues that pertain to specific family events, usually in the context of a private category a user has created to play with their own family.
- Timeline
- In a game, each player has their own timeline, represented as a chronological sequence of cards. Each time a player draws a card, the player must move the card into the correct spot in the timeline and submit their guess.
- Turn
- A player‘s chance to guess cards during a game. Each player in a game gets 1 chance per round. The game owner can set the number of cards a player is allowed to guess on their turn in a given game. The game owner can also set as a game option whether an entire round should be completed once a player achieves the game‘s win conditions, or if the game should stop immediately. If a game is in progress when a new player joins, that player will get as many turns as necessary to catch them up with the number of turns that other players have had. This allows players to drop in and out of a game and still remain competitive.
- Turn Order
- The sequencing of turns within a game round. The game owner may set the turn order as a game option. In a game, players appear in the players list in the order in which they joined the game. Sequential turn order is where players take turns in the order in which they are on the players list. Snake turn order is where players take turns sequentially the first round, then in reverse order the second round, and so on. Players take their turns in a randomized order each round when the Random turn order option is selected.
- User
- A person with an account. Users must be logged into their account to play games, manage clues, and manage categories. Users may sign up for an account with an email address and password, or any supported identity provider login (Facebook, Twitter, Apple, or Google).
- Win Condition
- The required number of correctly guessed cards in order for a player to be declared the winner of a game. The game owner may set the win condition as a game option. If none of the pre-defined win conditions are desired, the game owner may select “None (Owner Decides).” In this scenario, the game will continue until the game owner manually ends the game. There is also a game option for whether all players must have an equal number of turns before a winner can be declared. Forcing the entire round to end after a player satisfies the win condition creates an interesting dynamic. In this scenario, players that satisfy the win condition may need to gamble by exceeding the win condition with further guesses in order to prevent a come-from-behind win by another player prior to the end of the final round.