Real-time multiplayer quiz game for classrooms and immersive display rooms.
Supports gamepads, keyboard, and phone browsers simultaneously — no app install required.
Built for Igloo CAVE environments. Runs on any screen.
Status: Live in FE curriculum · Version: 0.1.3 · Engine: Unity (C#)
The host loads a question bank and creates a room. Players join via gamepad, keyboard, or phone — all simultaneously. Questions run on a timer, answers flash correct/wrong in real time, scores update live, and a full PDF report generates automatically at the end of the session.
Designed for Igloo CAVE 360° projection environments. Works on any display.
Gamepad — Xbox or PlayStation. A/B/X/Y map to the four answer options.
Squeeze trigger on setup screen to identify your controller.
Keyboard — R / T / Y / U keys for options A / B / C / D.
Phone — Scan the QR code on screen. Enter a name, pick an avatar, tap answers.
No app install. Works on any smartphone browser.
All three input methods work simultaneously in the same session.
| Backend | Best for |
|---|---|
| Local | LAN events — fast, no internet, phones on same Wi-Fi |
| Render | Cloud relay — host and players on different networks |
| Firebase | Campus guest Wi-Fi or mixed networks |
- Copy
WebControllerServer/public/firebase-config.local.example.jstoWebControllerServer/public/firebase-config.local.js - Put your real Firebase values in
firebase-config.local.js - Keep
WebControllerServer/public/firebase-config.jsas the committed placeholder file
firebase-config.local.js is git-ignored to prevent key leaks.
- Mixed input — gamepads, keyboard, and phones simultaneously
- QR code phone join, no app install required
- Room cap of 36 players (configurable)
- Live player list with avatars and answer status
- Streak lifelines — after 3 correct answers: 50/50, Skip, or Double points
- Speed bonus — answering in the first 30% of the timer earns extra points
- Prediction poll — vote YES/NO before the reveal; correct predictions earn a bonus
- Answer heatmap — phones show a bar chart of how players voted after each question
- Emoji reactions between questions
- Easy / Medium / Hard difficulty filtering with category-progressive rounds
- Auto-generated PDF and TXT reports at session end
- Igloo CAVE multi-display support (6-projector configuration)
Quiz files are plain JSON arrays. Drop them in the Quizzes/ folder next to the build.
[
{
"question": "What is the capital of France?",
"options": ["Berlin", "Madrid", "Paris", "Rome"],
"correctAnswerIndex": 2,
"category": "easy",
"remarks": "Paris has been the French capital since 987 AD.",
"image": "QuizImages/geography/france.png"
}
]See sample-quiz.json for a working example.
Required: question, options (exactly 4), correctAnswerIndex (0–3)
Optional: category, remarks, image, optionImages
| Answer | Keyboard | Gamepad |
|---|---|---|
| Option A | R | Button South (A / Cross) |
| Option B | T | Button East (B / Circle) |
| Option C | Y | Button West (X / Square) |
| Option D | U | Button North (Y / Triangle) |
The phone web UI (web-controller/public/) is a standalone HTML/JS frontend.
It communicates with the Unity host via WebSocket (Local/Render) or Firebase Realtime Database.
The local backend is a small Node.js server bundled with the build.
The Unity side uses the New Input System for controller management and
QuestPDF (via NuGetForUnity) for PDF report generation.
The Unity project source is closed. This repository contains the phone web
controller UI and sample quiz files.
Full project writeup: sagorahamed.com
Unity (C#) · Igloo Toolkit · Meta Quest 3 · Unity New Input System
QuestPDF · NuGetForUnity · Node.js · Firebase Realtime Database · WebSocket
Sagor Ahamed — Game Developer & XR Specialist
MSc Games & Extended Reality, University of Salford (2024)
Digital Innovation Technician, Wigan & Leigh College