How atr0jan/bsidessd-hacker-jeopardy works
This is a network-hosted, multiplayer Jeopardy game. The host adds teams and selects modes in the lobby, then runs clues and judges answers in the admin panel while a separate board displays game updates. The server routes browser views and broadcasts game events; the game logic manages rounds, scores, and clue state. README-documented capabilities also include Daily Doubles, Wheel of Chaos, Final Jeopardy, tie breakers, and results export. Source excerpts show the core event handling; some view-to-server relationships are documented in the README rather than shown in both endpoints.
Main entry points: app.py Flask and events · board.js Viewer board · admin.js Host controls · lobby.js Team lobby
Components 14
Game setup
- Team lobby
static/js/lobby.js - Lobby view
templates/lobby.html - Clue content
data/clues.json
Host controls
- Host controls
static/js/admin.js - Admin view
templates/admin.html
Audience display
- Viewer board
static/js/board.js - Board view
templates/board.html - Game sounds
static/sounds
Game runtime
- Flask and events
app.py - Game state
game_logic.py - Game history
app.py - Last results
last_game_results.json
Other components
- Host
- Players
Connections 16
- Host → Team lobby: sets teams
readme.md - Team lobby → Flask and events: starts game
static/js/lobby.js - Flask and events → Lobby view: renders
app.py - Flask and events → Admin view: renders
app.py - Flask and events → Board view: renders
app.py - Host → Host controls: judges clues
readme.md - Host controls → Flask and events: sends verdicts
static/js/admin.js - Flask and events → Viewer board: broadcasts updates
app.py - Players → Viewer board: views game
readme.md - Host controls → Viewer board: reveals clues
readme.md - Flask and events → Game state: updates state
app.py - Flask and events → Clue content: loads
app.py - Viewer board → Game sounds: plays
static/js/board.js - Flask and events → Game history: records verdicts
app.py - Host → Flask and events: exports standings
app.py - Flask and events → Last results: saves on reset
app.py