How kvega-210/rowdyhacks-demo works
HEIST HAVOC is a 2–30-player party heist game: a host runs the shared game while players use phones as controllers. Players join by scanning a QR code, race through minigames to drain a shared vault, sabotage or duel rivals, and finish with standings when the vault is empty. The graph focuses on the documented current version, v3, and its authoritative Java game server, phone and host clients, and major game systems. The sampled excerpts show selected server and client responsibilities; links for other documented capabilities use the README, not inspection of their implementations.
Main entry points: GameEngine.java Game engine · phone/app.js Phone app · HeistServer.java Game server · host/app.js Host screen
Components 18
Player Interfaces
- Phone app
v3/client/phone/app.js - Host screen
v3/client/host/app.js
Game Runtime
- Game server
v3/server/src/main/java/heist/HeistServer.java - Room management
v3/server/src/main/java/heist/rooms/RoomManager.java - Game engine
v3/server/src/main/java/heist/game/GameEngine.java - WebSocket protocol
v3/shared/protocol.js - Game balance
v3/server/src/main/java/heist/config/Balance.java - Signed vault keys
v3/server/src/main/java/heist/keys/KeySigner.java
Heist Gameplay
- Minigames
v3/client/minigames - Game modifiers
v3/client/modifiers - Rival duels
v3/client/rival - Wagers
v3/client/wagers - Nerves feedback
v3/client/presage/nerves.js
Persistence and Integrations
- Event logging
v3/server/src/main/java/heist/db/EventLog.java - Event storage
v3/server/src/main/java/heist/db/EventStore.java - Voice and AI
v3/server/src/main/java/heist/api/Tts.java
Other components
- Players
- Host operator
Connections 19
- Players → Phone app: control game
README.md - Host operator → Host screen: run game
README.md - Phone app → Game server: send intents
README.md - Host screen → Game server: control room
README.md - Game server → Phone app: send updates
README.md - Game server → Host screen: send updates
README.md - Game server → Room management: manage rooms
- Room management → Game engine: create game
- Game engine → Game balance: read settings
- Game engine → Event logging: record events
- Game engine → Signed vault keys: verify keys
- Event logging → Event storage: persist events
- Phone app → Minigames: play challenges
README.md - Game engine → Minigames: assign challenges
- Game engine → Game modifiers: apply modifiers
- Game engine → Rival duels: run duels
README.md - Game engine → Wagers: offer wagers
- Phone app → Nerves feedback: report nerves
- Game engine → Voice and AI: request narration