Introduction

J-Play is a place where you can play Jeopardy! with your friends, just like the real thing. Create your own game file (or use one of the example ones provided), and host your game, with players joining either locally or remotely with a join code.

Creating a game file

This help file will start with how to create a game file, as it is absolutely necessary for playing a game.

It is possible to manually create a game file (download the template here), or using the "Create" tab, which is available from the homepage, as shown below:

The create tab
Manual game creation

Creating a game manually takes a basic knowledge of JSON. To create a game manually, open the template.

The "rounds" array has 3 elements, representing the three rounds of a game (Jeopardy, Double Jeopardy, and Final Jeopardy).

For the Jeopardy and Double Jeopardy rounds, you must fill in each category, and for each of the 5 clues in each category, the text and correct response for each clue. If the category has any comments (e.g. a clarification of the category for the host to read to the contestants, like "each correct response starts with a C"), you may fill that in as well. Clue values will be automatically populated, and daily double locations will be randomly determined when the game file is loaded.

Manually creating a game

Final Jeopardy is a single object with a category, text, and response attribute. All three must be filled in.

Additionally, clue texts and responses can support basic HTML formatting (<i> for italic text, <br> for a new line). If you need a quotation mark, you can escape it with a backslash (\"):

Using basic HTML and escaping quotation marks

It is recommended that category names are limited to 25 characters, and clue texts are limited to 125 characters.

Using the Creator

Using the game creator is an easy way to generate and download the .json file for later use. You do not have to create the entire game in one sitting - rather, you may download the incomplete file and then reload it later to complete by using the "Download" and "Load" buttons.

To use the creator, select the round (J, DJ, or FJ for first round, Double Jeopardy, and Final Jeopardy, respectively), Category, and Value, and type in the clue and response. Upon selecting a category, you may also edit the category name and comments.

If any issues are present, a warning emoji (⚠️) will appear and the area will be outlined in red:

  • In the round selector: At least one category in the round has a blank name, or at least one clue in the round has a blank text or response field.
  • In the category selector: the name of the category is blank, or at least one clue in the category has a blank text or response field.
  • In the clue selector: This clue has a blank text or response field.
The creator interface

Starting a game

A game requires a host and at least one player. It is recommended that the host have a dual-screen setup, as the game key with correct responses will open in a new window, and the easiest way to control the game will be to use that window. While the site is mobile friendly and it is technically possible to do so, controlling the game from a tablet or smartphone is not recommended. Players are, however, encouraged to play from their phones.

To play a game, the host must first start by using the "Host" tab. There are two sets of options for starting a game:

  • Game type

    • Local - all players are physically present and will be buzzing in with the keyboard.
    • Remote - at least one player will be playing remotely from a different device. Other players who are physically present may join from their own device or buzz in using the keyboard.

  • Load game file

    • From computer - a .json file from your local machine, possibly having been generated using the creator. If there is invalid or missing data in this file, the game will not start.
    • From server - a small set of games compiled from real Jeopardy! clues has been provided for use.

Once a file is loaded, the game board will show, and a the browser will attempt to open a key window. If the key window does not open, disable your popup blocker. If you accidentally close the key window, press "K" from the main window to reopen it. For a remote game, the join code will be displayed in this window. Additionally, this window will display the correct response to each clue, the scores, and any relevant game controls for the host. The main window should be screen-shared with players in a remote game. The key window should be concealed from view in a local game, and not shared in a remote game.

Joining a game

Local players

Whether the game itself is local or remote, local players (players who will play on the same machine as the host) can be added to the game through the interface itself, using the "edit player" buttons.

The game board before players are added

A player must be given a text name. They may also draw their name (like on the real show) in the blue canvas, but that is optional. If they do not draw their name, their lectern will display their name as text.

Also note the "buzzer key" section. Local players must set the key they wish to use in order to buzz in. By default, the left, middle, and right players (as viewed on the screen) will use the left, up, and right arrows to buzz, but these can be changed. No two local players can use the same key, obviously, and the spacebar, "C", "X", "K", and down arrow keys are reserved for host use and may not be used by players.

The player settings window

Click on a player's name in the lectern to edit or remove the player once they are saved.

The player's lectern after saving
Remote players

The host will get a join code from the key window when they start the game.

The key window with the join code

Remote players will log into the game using their own devices using their name and the join code. As with local players, they must provide a text name, and may optionally draw their name with the canvas.

Joining a game remotely

Upon joining the game, the player will see their lectern and a buzzer button. They may click the button or press spacebar to buzz during the game. Before the game starts, the buzzers are live so that players may test them.

Player buzzer

Playing the game and game flow

The host has ultimate control over the game, and the key window will assist by describing the current game state, and what input the game is expecting from the host, if any. This section will describe what actions/commands are available at any given time in the game and point out some other important features of the interface.

Control panel in the key window
Host controls

The host has 4 basic controls:

  • Host key - The "host key" is any of the spacebar, down arrow, or the advance button in the key window, and acts as an all-purpose button that advances the game state.
  • Correct key - "C" or the "correct" button in the key window. Marks a contestant's answer correct when necessary.
  • Incorrect key - "X" or the "incorrect button" in the key window. Marks a contestant's answer incorrect when necessary.
  • Open key - "K", opens the key window. If a key window is already open, the old key window is closed.

These controls will be referred to further down in this section as the flow of the game is described.

Pregame

When the game starts, it is in a "pregame" state. Players may join or be added to the game.

Press the host key when ready to start the game. Press "start" in the ensuing prompt to begin the game.

Board intro

The board is populated. In the key window, the location of any daily doubles will be marked by inverting its colors. The categories are initially concealed.

A daily double is marked with a yellow background and blue text

Use the host key to scroll through the categories. You must press the host key after each category, as it may have comments that the host needs to read to the players.

Revealing the categories. The left side is the player view in a local game, and the right side is the view in the key window when a comment exists for a category
Clue select

At any time when a clue is to be selected, the player in control of the board is highlighted with a white line underneath their lectern. Once the player calls out a category and value, the host may click the clue in the main window or the key window to select it.

Alex is in control of the board

When a clue is selected, if it is not a Daily Double, the host will read it and then press the host key to activate the player buzzers. If a player buzzes in before the buzzers are activated, they will be locked out for 250 milliseconds, as in the real game. When the buzzers are active, the clue display will light up white on both sides of the clue.

The key window displays the clue and the correct response for the host
The clue display lights up white on both sides when the buzzers are activated

When a player buzzes in, the host should call on that player and ask for a response. The player should get about 5 seconds to give a response in the form of a question. The red lights above the lectern indicate the time remaining. The host may press the correct key ("C" or the "Correct" button in the key window) or the incorrect key ("X" or the "Incorrect" button in the key window) to judge the response at any time during the timer or after it has expired. If a player gives an incorrect response, they are locked out for the remainder of that clue. That is, a player may only buzz in once per clue. If an incorrect response is given, the buzzers are reactivated and another player may buzz in. If the buzzers are activated and no one buzzes in within 3.5 seconds, the clue times out and the host will indicate the correct response and press the host key to continue the game.

Barbara has buzzed in
Daily Doubles

If the selected clue is a Daily Double, the player in control shall indicate their wager. The wager must be at least $5. In the Jeopardy round, the wager may not exceed the greater of $1,000 or the player's current score. In the Double Jeopardy round, the wager may not exceed the greater of $2,000 or the player's current score. Upon indicating their wager, the host will be able to enter it in the key window.

Alex finds a Daily Double and may wager $5-$1400

The host will enter the wager and read the clue, and press the host key to activate the timer. After 7 seconds, the clue will time out. The host, however, may still judge the contestant's answer to be correct or incorrect, even if the clue has timed out.

Final Jeopardy

In Final Jeopardy, players will see a category, and then wager up to their current score (with a minimum of 0, of course) on one clue. Upon revealing the category, players will have an opportunity to make a wager, with unlimited time. For remote players, they will be able to enter their wager on their own device. For local players, they should write their wagers on a piece of paper and give it to the host to enter in, as wagers are unknown to the other players.

The host will enter Final Jeopardy wagers for all local players. Remote players may enter their own wagers

When all wagers are entered, the clue will display, and the host will read it. When the host presses the host key, a 30-second timer will start. Remote players will be able to enter their responses on their own devices. Local players will write their responses on a piece of paper and give it to the host, who can enter them in the key window, out of sight of the other players.

Host may enter response for local players. Responses from remote players will automatically populate

When the 30-second timer expires, in ascending order of score, the responses and wagers will be revealed. The host will press the host key to reveal each player's response, then either the correct or incorrect key to judge the response, the host key to reveal te player's wager, and, finally, the host key one more time to adjust the player's score accordingly.

Alex's Final Jeopardy results revealed