GameNight
Docker app from Cdybkr's Repository
Self-hosted multiplayer party games for your living room: any phone, tablet, or laptop on your LAN becomes a controller.
Overview
Readme
View on GitHub๐ฎ GameNight
Self-hosted multiplayer party games for your living room. No internet. No accounts. Just fun.
Node.js Socket.io Express License: MIT Games Multiplayer No frameworks
โโโโโโโ โโโโโโ โโโโ โโโโโโโโโโโโโโโโ โโโโโโ โโโโโโโ โโโ โโโโโโโโโโโโ
โโโโโโโโ โโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโ โโโ โโโโโโโโโโโโ
โโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโโ โโโโโโ โโโโโโโโโ โโโโโโโโโโโโ โโโ
โโโ โโโโโโโโโโโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โโโโโโโโโโโ โโโ
โโโโโโโโโโโโ โโโโโโ โโโ โโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโโโ โโโ โโโ
โโโโโโโ โโโ โโโโโโ โโโโโโโโโโโโโโ โโโโโโโโ โโโโโโโ โโโ โโโ โโโ
GameNight turns any device on your local network into a party game console.
Run one command โ share the URL โ play instantly.
๐ฒ Games
| Game | Players | Vibe | |
|---|---|---|---|
| ๐ช | Mongolpuri | 4โ15 | Social deduction โ lies, trust, and midnight murder |
| ๐ | UNO | 2+ | Classic card game with skips, reverses, and wild cards |
| ๐ง | Quiz | 2+ | 15-question trivia from the internet โ faster answers score more |
| โญ | Tic Tac Toe | 2+ | Classic 1v1 with score tracking and match formats |
| ๐จ | Scribble | 3+ | Draw a word while your friends race to guess it |
โจ Features
- ๐ Fully local โ runs on your LAN, no internet required after setup
- ๐ฑ Works everywhere โ phone, tablet, laptop โ any browser
- ๐ Room codes โ create a room, share the 6-letter code or invite link, done
- ๐ Smart invite links โ link pre-fills the room code and shows only the game being joined
- ๐ญ 100 avatars โ auto-assigned by name for known players, random for new ones; open a modal to browse and change
- ๐พ Remembered preferences โ name and avatar are saved and restored on your next visit
- โ๏ธ Configurable โ host adjusts timers, rounds, match format before game starts
- ๐ Built-in rules โ tap "How to Play" to learn any game
- ๐ Reconnect support โ refresh the page and jump back in
- ๐ป Spectator mode โ eliminated players watch the action
- ๐ Dark UI โ polished animations, countdown timers, role cards
๐ Quick Start
Prerequisites
Install
git clone <repo-url>
cd gamenight
npm install
Run
| Platform | Command |
|---|---|
| Windows | Double-click start.bat or run it in terminal |
| macOS / Linux | ./start.sh |
| Anywhere | npm start |
Open http://localhost:4000 in your browser.
๐ Network Play
When the server starts it prints every URL your friends can use:
๐ฎ GameNight is live!
Local: http://localhost:4000
Network: http://192.168.1.42:4000 โ share this!
Network: http://10.0.0.5:4000
Anyone on the same WiFi or LAN can open the Network URL directly โ no setup needed on their end.
The server also advertises itself via mDNS (Bonjour), so on most devices you can use the stable hostname instead:
http://gamenight.local:4000
Tip:
gamenight.localworks on macOS, iOS, Android, and most Linux desktops out of the box. Windows may need Bonjour for Windows. If it doesn't resolve, fall back to the IP shown in the terminal.
โ๏ธ Game Settings
The room creator can tune settings in the lobby before the game starts. Everyone else sees the current configuration.
| Game | Configurable |
|---|---|
| ๐จ Scribble | Draw time (40โ120 s) ยท Rounds (2โ5) ยท Word choices per turn (2โ4) |
| ๐ช Mongolpuri | Discussion time ยท Voting time |
| โญ Tic Tac Toe | Free play ยท Best of 3 / 5 / 7 |
| ๐ UNO | No configurable settings โ standard rules apply |
| ๐ง Quiz | Questions (10 / 15 / 20 / 25) ยท Time per question (10 / 15 / 20 / 30 s) |
๐ How to Play
Rules are built into the app โ click "How to Play" on any screen. Here's the quick version:
๐ช Mongolpuri
Players are secretly assigned Killer, Doctor, or Villager. Roles are hidden by default โ tap your role card to reveal it. Each night, every player confirms they are awake (villagers tap "I'm awake"; killer and doctor choose their target). Once all players have acted, the server waits a random delay then resolves the night. At dawn the village debates during a timed discussion, then votes to eliminate a suspect. Villagers win by voting out the Killer. The Killer wins by reducing the living players to two.
In larger games there may be multiple Doctors โ roughly one per five players โ to keep the game balanced.
๐ UNO
Standard UNO rules. Each player starts with 7 cards. On your turn, play a card that matches the top discard by color or value, or draw one from the deck. Special cards: Skip ends the next player's turn, Reverse flips direction, +2 forces the next player to draw two, Wild lets you choose the active color, Wild +4 does the same and forces a four-card draw. First player to empty their hand wins. Your name is displayed in the top-left of the game header.
๐ง Quiz
The server fetches questions from the Open Trivia Database at game start and sorts them easy โ medium โ hard. While questions are loading, players see a "Fetching questionsโฆ" screen; the first question appears automatically once the fetch completes (usually under a second, up to ~6 s if the API rate-limits). Each question shows 4 lettered options (AโD) with a countdown timer. Correct answers score 500โ1000 points based on speed โ the first player to answer correctly earns a +200 bonus (marked with โก). After each question the correct answer is revealed with animations alongside the updated leaderboard. The game-over ranking table shows each player's correct-answer count alongside their total score. Requires internet access when starting the game.
๐จ Scribble
One player draws a secret word on a shared canvas while everyone else types guesses in the chat. Faster correct guesses = more points. The drawer earns bonus points for each correct guesser. Hints appear as time runs low. Roles rotate every turn.
โญ Tic Tac Toe
Classic 3ร3 grid. Get three of your symbol in a row (horizontal, vertical, or diagonal) to win. X always goes first. Symbols swap each game. In match formats, first to reach the win target takes the match. Supports single-elimination tournaments for groups.
๐ ๏ธ Tech Stack
| Layer | Tech |
|---|---|
| Runtime | Node.js |
| HTTP server | Express |
| Realtime | Socket.io (WebSockets) |
| Drawing | HTML5 Canvas API |
| Frontend | Vanilla JS, pure CSS |
| Styles | CSS custom properties, no framework |
๐ Structure
gamenight/
โโโ server.js # All game logic + Socket.io events
โโโ public/
โ โโโ index.html # Single-page app shell
โ โโโ style.css # Dark theme, animations
โ โโโ js/
โ โโโ app.js # Socket setup ยท lobby ยท views ยท avatars ยท settings
โ โโโ killerdoctor.js # Mongolpuri client UI
โ โโโ tictactoe.js # Tic Tac Toe client UI
โ โโโ scribble.js # Scribble canvas + chat
โ โโโ uno.js # UNO client UI
โ โโโ quiz.js # Quiz client UI
โโโ start.bat # Windows one-click launcher
โโโ start.sh # macOS / Linux launcher
โโโ package.json
๐ License
MIT โ do whatever you want with it.
No cloud. No tracking. No nonsense. Just game night.
Categories
Related apps
Explore more like this
Explore allLinks
Details
ghcr.io/codyburker/gamenight:latestRuntime arguments
- Web UI
http://[IP]:[PORT:4000]/- Network
bridge- Shell
sh- Privileged
- false
Template configuration
Host port for the GameNight web UI. Everyone on the LAN opens this to create or join rooms.
- Target
- 4000
- Default
- 8013
- Value
- 8013
Container timezone.
- Default
- America/Indiana/Indianapolis
- Value
- America/Indiana/Indianapolis