openvibers/breakroomsimulator

🏓 Amazon Break Room Simulator


A free, open-source realtime multiplayer 3D web game recreating an Amazon fulfillment
center break room. Runs on desktop and mobile — no build step,
vanilla JS + Three.js.

🎮 Play it live: simulator.rest · 💻 Source: github.com/OpenVibers/BreakRoomSimulator

Issues and pull requests are welcome — map fixes, minigames, props, anything.

Run it

git clone https://github.com/OpenVibers/BreakRoomSimulator.git
cd BreakRoomSimulator
npm install
npm start          # → http://localhost:3000

Open the URL on any device on your network (http://<your-ip>:3000) and everyone shares
the same break room. ?autoguest in the URL skips the login screen with a guest account.

The building (the real route, from countless break-room trips)

You spawn on the landscaped front walkway (planter beds, Amazon Tours signs,
food truck, flag pole, bollarded plaza) under the huge white facade with its
blue roofline stripe, wood-band tower with the Amazon smile, and blue
"main entry" canopy — then enter the way associates really do:

main entry glass doors → entry lobby (blue walls, Amazon Family World
Map mural, green hedge wall with the neon "Welcome to PAE2" script, red
garland, Enter / Do-Not-Enter lanes) → badge gates (E to badge; paddles
open) → security (freestanding white PAE2 desk island, three metal-detector
lanes + x-ray belt feeding the Safe to Go arch into the FC, Peccy statue,
thank you / Exit band) → through the mural wall's locker opening →
locker hallway (tan locker banks, teal floor path) → double
doors by the red clock + flags → cafeteria (avenue C market, dining
zones, couch corner, ping pong, giant Connect 4, chess, arcade, bathrooms,
smoke cage outside). All exterior cafeteria doors are emergency-exit-only.

Admin & level editor

• The first registered account automatically becomes admin
  (or grant later: node server/server.js --admin SomeName).
• Admins get a 🛠️ button — a persistent level editor: place, move, rotate,
  scale, and delete props (tables, chairs, couches, lockers, vending, walls,
  invisible blockers, …). Edits save to data/map-edits.json, sync live to
  every connected player, and survive restarts.

Features

• Accounts — register/login (scrypt-hashed passwords, JSON store) or play as a guest.
  Vest color and win stats persist per account.
• Realtime multiplayer — websocket sync (12 Hz snapshots): avatars, walk/run/sit
  animation, name tags, chat with speech bubbles, join/leave feed.
• The room:
• Lounge: leather couches inside blue-tape outlines labeled COUCH, oriental rug,
  coffee tables, bookshelves with board games, palm plants, Together at Amazon banner
• Games corner: two JOOLA-style ping pong tables, yellow PRIME BREAKER arcade
  cabinet, chess table, two giant Connect 4s, cornhole board, stacked-chair zone
• Dining hall: 40 clusters of folding tables, ~500 chairs color-zoned
  green → brown → orange → yellow, napkin dispensers, July Newsletter table tents
• avenue C micro-market: glass-door coolers, snack slat-walls, self-checkout kiosks,
  Pepsi vending machines, Red Bull cooler, coffee station, microwaves, lockers
• Annex corridor through the wide passage: day lockers,
  avenue C café/servery nook, glass-walled wellness room, teal walking-path
  tape with red STOP floor decals, second entrance doors
• International flags around the whole perimeter + strung across the hall,
  blue-fascia recessed ceiling sections with yellow accent trim, pendant lights,
  live red LED clocks, TVs cycling live slides (online count, ping pong ladder),
  floor-to-ceiling windows with a parking lot, cars, trees, and a stop sign outside
• Playable games (server-authoritative):
• 🏓 Ping pong — timing-based rallies, first to 7; solo practice mode
• 🔴 Giant Connect 4 — click a column to drop; win detection + rematch
• ♟️ Chess — casual rules (capture the king), move validation, promotion
• 🕹️ PRIME BREAKER — breakout arcade game with server-wide highscore board
  shown on the cabinet screen
• 🛒 Grab snacks/drinks/coffee — item shows in your avatar's hand
• Mobile — virtual joystick, drag look, touch buttons, fullscreen.

Controls

| Desktop | Mobile |
|---|---|
| WASD walk, Shift run, Space jump (bhop-friendly), Ctrl crouch | joystick (push far = run), 🔽 crouch, ⤒ jump |
| Mouse (click to lock) to look · V or 📷 first person | drag right side |
| E interact · F use item / swing prop | E button |
| 1-6 hotbar · Tab/🎒 inventory (drag & drop) | tap hotbar / 🎒 |
| Click column/square to play boards | tap column/square |
| Enter chat | 💬 button |

Movement is Source-engine style: ground friction + wish-direction acceleration,
air-strafe control with capped air acceleration, and jumps that preserve
horizontal velocity. Collect snacks (consumable), melee props (paddle, broom,
tape gun, wrench, banana, cardboard tube — swing with F or click in first
person), and clothes (hats/vests) from vending machines and pickups around the
facility. Inventory persists on your account.

Stack

Node + Express + ws (no build step), Three.js frontend served as ES modules.
All textures are procedurally drawn on canvas — flags, signage, vending machines,
the rug — no external assets. Data persists to data/*.json.

Website & public hosting (simulator.rest)

The server serves a marketing landing page at / and the game itself at /play.
Real screenshots for the landing page live in public/img/.

Production (simulator.rest) runs the bare-metal setup below:
Cloudflare (proxied DNS) → nginx (Let's Encrypt TLS, websocket proxy, Cloudflare
real-IP restore) → the Node server as the breakroom systemd service in
/opt/BreakRoomSimulator. Deploying an update there:

ssh <server> 'cd /opt/BreakRoomSimulator && sudo git pull && sudo npm install --omit=dev && sudo systemctl restart breakroom'

One-command deploy (Docker + Caddy, automatic HTTPS)

On any Linux server (1 vCPU / 1 GB is plenty to start):

1. Point DNS: A records for simulator.rest and www.simulator.rest → your server's IP.
2. Copy the project to the server (or git clone it), then:

docker compose up -d --build

That's it. The game container runs the Node server (only exposed to localhost),
and the caddy container terminates TLS for simulator.rest with an automatic
Let's Encrypt certificate and proxies HTTP + websockets through. Player accounts,
highscores and map edits persist in ./data on the host.

• First registered account becomes admin (or grant later: node server/server.js --admin NAME
  won't work while the server runs — instead stop, run once with the flag, restart).
• Update: git pull && docker compose up -d --build.
• Logs: docker compose logs -f game.

Without Docker

npm install
PORT=3000 npm start

then put any TLS-terminating proxy in front (the websocket path is same-origin, so a
plain reverse_proxy/proxy_pass with upgrade headers is all that's needed). Example
nginx location block:

location / {
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
}

A systemd unit for bare-metal installs:

[Unit]
Description=Amazon Break Room Simulator
After=network.target

[Service]
WorkingDirectory=/opt/amazon-break-room-simulator
ExecStart=/usr/bin/node server/server.js
Restart=always
Environment=PORT=3000
User=www-data

[Install]
WantedBy=multi-user.target