A Jeopardy! game frontend for things with buzzers.
For more context, we recommend reading things with buzzers: building them and things with buzzers: playing Jeopardy!.
PS: We didn't create this from scratch. This is a modified fork. See Fork and acknowledgments.
You are missing the context, what this is all about? Have a look at
- (1) things with buzzers: sports competition frontend
- (2) things with buzzers: websocket
- (3) things with buzzers: hardware
- Features
- Screenshots
- Getting Started
- Known Issues
- Fork and acknowledgments
- Disclaimer
- Text support for answers
- Audio support for answers
- Video support for answers
- Native support for things with buzzers: hardware buzzers via things with buzzers: websocket
- Possibility to run offline
- Support for your own game and answer/question sets
- Support for using the game and answer/question sets from J! Archive (deactivated in favor of your own question sets)
A single question
Backend game overview
Backend game question overview
Backend game question
If you don't have a buzzer, build one!
Here we run the Jeopardy! app with our example question set from the game-content folder.
Be aware that there is only one full game available.
Hence the clickpath is important:
Example Season 2 -> Example Season 2 - Game #1
This app runs on Node.js, make sure to install it before continuing. Furthermore, we run this game in combination with twb-websocket.
Important: The twb-jeopardy app and the twb-websocket must run on the same server.
- Clone the twb-jeopardy repository to your computer
$ git clone [email protected]:andygrunwald/things-with-buzzers-jeopardy.git
$ cd things-with-buzzers-jeopardy- Download, install and start twb-websocket
- Copy the game questions from the game-content folder into the
static/twb-jeopardy/folder of twb-websocket:
$ mkdir -p <folder-of-twb-websocket>/static/twb-jeopardy/
$ cp game-content/* <folder-of-twb-websocket>/static/twb-jeopardy/As an alternative, you can symlink it:
$ ln -s <folder-of-twb-jeopardy>/game-content <folder-of-twb-websocket>/static/twb-jeopardy/- Install dependencies:
$ npm install && bower install- Start the app things with buzzers: Jeopardy! app:
$ TWB_QUESTION_SERVER="localhost:8080" node app.js- Open http://localhost:3000/ for the host interface.
- Open http://localhost:3000/#/board for the clue board.
It is required to set the TWB_QUESTION_SERVER environment variable. This the IP + Port combination of the twb-websocket server.
You can also run this Game inside a Docker container.
- Clone the twb-jeopardy repository to your computer
$ git clone [email protected]:andygrunwald/things-with-buzzers-jeopardy.git
$ cd things-with-buzzers-jeopardy- Download, install and start twb-websocket
- Copy the game questions from the game-content folder into the
static/twb-jeopardy/folder of twb-websocket:
$ mkdir -p <folder-of-twb-websocket>/static/twb-jeopardy/
$ cp game-content/* <folder-of-twb-websocket>/static/twb-jeopardy/As an alternative, you can symlink it:
$ ln -s <folder-of-twb-jeopardy>/game-content <folder-of-twb-websocket>/static/twb-jeopardy/- Build and start the container:
$ make run-docker- Open http://:3000/ for the host interface.
- Open http://:3000/#/board for the clue board.
The TWB_QUESTION_SERVER environment variable is automatically set to host.docker.internal:8080.
This the IP + Port combination of the twb-websocket server.
If you want to override it, execute this command in Step 4: TWB_QUESTION_SERVER=<YOUR HOST>:8080 make run-docker
Once the server is started, the board will play the Jeopardy! theme to get your contestants pumped up. The host can then select from any game (on J! Archive or your own created question set), starting by season, then drilling down to individual games. When the host chooses a game, a summary screen will appear, showing the categories for the game and how many clues are available for each category. We recommend finding a game with all the clues available for the best experience.
Once the game has been chosen, the host enters the contestant names at the top of the screen and clicks the "Start Game" button. The music ends on the board and the Jeopardy! round will be displayed.
This is pretty easy for the contestants, the person in control of the board picks a clue, the host reads it, they hit the buzzer to answer, repeat until no clues remain.
If you've decided to step into the shoes of Alex Trebek, you'll have to learn a bit.
There's a pin next to the name of the player in control of the board. Call on them to pick a clue. Click on the clue, and it will pop up on your screen as well as the board. Read it to the contestants, and they buzz to answer. Your screen will also have the answer, so be sure not to read that! If someone buzzes in and gets it wrong, click the X underneath their name. If they get it right, hit the checkmark. Hit the Submit button to end the clue and update scores. The control pin will automatically switch to whichever player answered correctly. If no one gets it right, control of the board does not change.
If you see a yellow "DD" next to a clue, it's a Daily Double! Don't start reading it right away! The contestant who got it needs to bid first. Make sure the correct name is highlighted, enter the contestant's bid, then hit the Confirm button. Now read the clue and record whether they get it correct.
If you see a red "TS" next to a clue, that means it was a Triple Stumper on the show. Nothing too significant, but sometimes it's nice to tell your contestants they're smarter than the folks on the show that day!
When all the clues are gone, hit the "End Round" button. Between the Jeopardy! and Double Jeopardy! rounds, the contestants' scores will be displayed on the board, and control will be given to the player with the lowest score.
When you reach Final Jeopardy!, you must enter the contestants' wagers before the question is displayed.
If you really want to get serious, there will be a link to J! Archive's wagering suggestions page, automatically populated with your contestants' names and scores. If you're actually practicing for Jeopardy!, you'd better be learning how to wager properly. Confirm the wagers, read the question (the Think! music will automatically start playing), let your contestants write down their answers, then enter the results. Hit the "End Round" button one last time to display your contestants' final scores on the big screen, and you're all done!
Let's reiterate that, be sure to hit "End Round" at the end of Final Jeopardy!
This will display the final scores, as well as save a log of the game's results to a file on your computer in the games folder.
You are also given some convenient links to the J! Archive so you can see how the real game played out.
You can then use the "Reset Game" button if you'd like to play again or use your browser's Back button to go back and pick another game.
It is possible to create your own answer/question sets.
We provide one full example in the game-content folder.
To the general structure:
- There can be one up to n Seasons.
- One Season can contain one up to m Games.
- One Game contains one Jeopardy! Game.
-
Open the
seasons.json. -
Add the following content (adjust it to your needs):
{ "id": "my-new-funny-event", "name": "Funny Event (March 2019 in DUS)", "description": "Put a useful description here. Maybe Location, date or topic of the game.", "note": "A random note you can put here" } -
Create a new file names
my-new-funny-event.json(like theidyou entered in theseasons.json) and add the content:[ { "id": "my-new-funny-event-game-1", "name": "Funny Event - Game #1", "description": "Game #1 of my funny event - Blue edition", "note": "" }, { "id": "my-new-funny-event-game-2", "name": "Funny Event - Game #2", "description": "Game #2 of my funny event - Red edition", "note": "" }, [...] ]
-
Add a file named
my-new-funny-event-game-1.json(like theidyou entered in themy-new-funny-event.json) in the game folder and add the following content:{ "id": "my-new-funny-event-game-1", "game_title": "Show #7929 - Thursday, February 14, 2019", "game_comments": "", "game_complete": true, "category_J_1": { "category_name": "THE TOP 25 ROMANTIC COMEDIES", "category_comments": "(Alex: According to a list put together by Vanity Fair.)", "clue_count": 5 }, "category_J_2": { [...] }, [...] "clue_J_1_1": { "id": "359675", "clue_html": "He stars in No. 4, No. 7 & No. 16: <br>"Bridget Jones's Diary", "Notting Hill" & "Four Weddings and a Funeral"", "clue_text": "He stars in No. 4, No. 7 & No. 16: \"Bridget Jones's Diary\", \"Notting Hill\" & \"Four Weddings and a Funeral\"", "correct_response": "Hugh Grant" }, "clue_J_2_1": { "id": "359682", "clue_html": "No bull--we're stuck on this brand whose mascot is seen <a href=\"http://www.j-archive.com/media/2019-02-14_J_11.jpg\" target=\"_blank\">here</a>", "clue_text": "No bull--we're stuck on this brand whose mascot is seen here", "correct_response": "Elmer\\'s Glue", "media": [ "http://localhost:3000/media/2019-02-14_J_11.jpg" ] }, "clue_J_2_4": { "id": "359680", "daily_double": true, "clue_html": "Napoleon was heard to say that this, which he was part of, is merely "a fable agreed upon"", "clue_text": "Napoleon was heard to say that this, which he was part of, is merely \"a fable agreed upon\"", "correct_response": "history" }, [...]category_J_<CAT_ID|1..6>: A single category. Six categories can be placed there.clue_J_<CAT_ID>_<QUESTON_ID|1..5>: A single question.clue_J_1_2will be in category 1 question 2
This is how a regular game looks like. Additionally, you can add a Double Jeopardy! and Final Jeopardy! Round.
Double Jeopardy! Rounds apply the same scheme as normal Categories and Questions.
The difference is that in the JSON Key, the J will be replaced with a DJ.
Like
[...]
"category_DJ_6": {
"category_name": "TV REBOOTED",
"category_comments": "",
"clue_count": 5
},
"clue_DJ_1_1": {
"id": "359705",
"clue_html": "Now in their 40s, this title trio returns to fight for justice in Dumas' "Twenty Years After"",
"clue_text": "Now in their 40s, this title trio returns to fight for justice in Dumas' \"Twenty Years After\"",
"correct_response": "the Three Musketeers"
},
[...]Only one final Jeopardy! round can be added.
Just add the following into the my-new-funny-event-game-1.json file:
"category_FJ_1": {
"category_name": "COLORFUL GEOGRAPHY",
"category_comments": ""
},
"clue_FJ": {
"clue_html": "Named for a soldier killed in 1846 at the start of a war, it was in the news again as a port of entry to the U.S. in 2018",
"clue_text": "Named for a soldier killed in 1846 at the start of a war, it was in the news again as a port of entry to the U.S. in 2018",
"correct_response": "Brownsville"
} "clue_J_6_5": {
"id": "20190319165",
"clue_html": "",
"clue_text": "",
"correct_response": "Valve Theme (Half-Life / Counter Strike)",
"audio": "http://localhost:8080/static/twb-jeopardy/my-new-funny-event-game-1/Valve-Theme-Hazardous-Environments.mp3"
} "clue_J_1_5": {
"id": "20190319115",
"clue_html": "",
"clue_text": "",
"correct_response": "Batman",
"media": [
"http://localhost:8080/static/twb-jeopardy/example-season-2-game-1/batman.png"
]
}, "clue_J_1_5": {
"id": "20190319115",
"clue_html": "",
"clue_text": "",
"correct_response": "Star Wars",
"video": "http://localhost:8080/static/twb-jeopardy/my-new-funny-event-game-1/star-wars.mp4"
},If you prefer to play games from J! Archive instead of coming up with your own game and answer/question set, you need to modify the source code slightly.
- Open the routes/api.js file
- Search for
J! Archive-Activation - Add comments in front of the lines with
TWB_QUESTION_SERVER - Remove the comments of the lines with http://www.j-archive.com/
- Restart the game server
- Seasons and games from http://www.j-archive.com/ should appear now
- You have to end the round when all clues are answered manually.
- Contestants are only shown their scores between rounds, at Daily Doubles, and before Final Jeopardy! Be a good game master and announce them in between.
- There is no easy way to adjust a contestant's score if the host makes a mistake. When necessary, we just added some scoring notes in the field with the contestant's name.
- There is no way to un-answer a clue or un-end a round. Once they're gone, they're gone, unless the entire game is reset.
- Media is proxied from J! Archive, so if a clue had pictures, they would be shown on the game board. However, media frequently comes up missing on J! Archive. The links are there, but they don't go to anything.
- The Jeopardy! theme played at the start is streamed from YouTube. We suggest you download the video beforehand and switch to the game once finished.
- You have to use your own game and answer/question set OR downloading the J! Archive games beforehand.
This repository is a (modified) fork of theGrue/jeopardy which is based on btford/angular-socket-io-seed.
The main acknowledgments belongs to theGrue, btford + contributors. Thanks a lot! You created a huge thing.
Borrowing this one from J! Archive, just in case.
The Jeopardy! game show and all elements thereof, including but not limited to copyright and trademark thereto, are the property of Jeopardy Productions, Inc. and are protected under law. This website is not affiliated with, sponsored by, or operated by Jeopardy Productions, Inc.