How shruichan/virtual-bee-swarm works
HONEYMOON is a mixed-reality Quest bee-swarm game, supported by a Hive backend and Mentra glasses companion. The main player journey is signing the clipboard, then calming and feeding bees, defending the hive, and resolving the meadow-window what-if. The graph also shows the operator/dialogue backend, glasses scan-and-voice flow, and Bee Scout vision path. Unity gameplay sources are not represented in the supplied tree, so that subsystem is identified by its documented project directory; edges are limited to README statements or sampled/indexed references.
Main entry points: server.ts Hive server · app.ts Glasses session app · BeeswaxBus.cs Unity Hive client · worker.py Vision worker
Components 22
Quest gameplay
- Mixed-reality game
unity/VirtualBeeSwarm - Unity Hive client
unity/BeeswaxClient/Runtime/BeeswaxBus.cs - Unity protocol
unity/BeeswaxClient/Runtime/BeeswaxProtocol.cs
Hive backend
- Hive server
hive/src/server.ts - Beat Board
hive/src/board.ts - What-if answers
hive/src/ask.ts - Dialogue director
hive/src/director.ts - Service health
hive/src/services.ts - Hive protocol
hive/src/protocol.ts
Glasses companion
- Glasses status UI
glasses/src/ui/App.tsx - Glasses session app
glasses/src/background/app.ts - Photo scanner
glasses/src/background/scan.ts - Speech capture
glasses/src/background/ear.ts - Hive connection
glasses/src/background/hive.ts - UI channels
glasses/src/shared/channels.ts
Bee Scout vision
- Vision worker
bee-scout/hive/scout-vision/worker.py - Visual recognizer
bee-scout/hive/scout-vision/scout_vision/recognizer.py
External services
- Orbis relay
hive/orbis-relay/relay.py - AI and speech providers
- Visko Orbis
- MentraOS
Other components
- Quest player
Connections 21
- Quest player → Mixed-reality game: plays
README.md - Mixed-reality game → Unity Hive client: connects through
README.md - Unity Hive client → Unity protocol: uses contract
unity/BeeswaxClient/Runtime/BeeswaxBus.cs - Unity Hive client → Hive server: connects to
README.md - Hive server → Beat Board: serves
hive/src/server.ts - Hive server → What-if answers: routes what-ifs
hive/src/server.ts - Hive server → Dialogue director: loads
hive/src/server.ts - Hive server → Service health: reports health
hive/src/server.ts - Hive server → Hive protocol: uses contract
hive/src/server.ts - Glasses status UI → UI channels: uses types
glasses/src/ui/App.tsx - Glasses session app → UI channels: publishes status
glasses/src/background/app.ts - Glasses session app → Photo scanner: wires
glasses/src/background/app.ts - Glasses session app → Speech capture: wires
glasses/src/background/app.ts - Glasses session app → Hive connection: wires
glasses/src/background/app.ts - Hive connection → Hive server: sends requests
- Glasses session app → MentraOS: uses session SDK
README.md - Vision worker → Visual recognizer: recognizes frames
bee-scout/hive/scout-vision/worker.py - Vision worker → Hive server: posts frames
bee-scout/hive/scout-vision/worker.py - Hive server → AI and speech providers: uses for speech and answers
README.md - Orbis relay → Visko Orbis: relays live scenes
README.md - Hive server → Orbis relay: optional live-video path