QUIZ GUIDE

Mastering the Three Quiz Game Modes: A Developer's Guide to Why Each Mode Exists

Not just features - these are solutions to real classroom problems. Here's why Buzzer, Quiz, and Auto modes were engineered, and how they work under the hood.

Buzzer Mode: Why Speed Trumps Accuracy in Technical Training

The Technical Challenge: Sub-200ms Response Time

// WebSocket server configuration for minimal latency
const WebSocket = require('ws');
const wss = new WebSocket.Server({ 
  port: 8080,
  perMessageDeflate: false  // Disable compression for speed
});

wss.on('connection', (ws) => {
  ws.isAlive = true;
  ws.pingInterval = setInterval(() => {
    if (ws.readyState === WebSocket.OPEN) ws.send('ping');
  }, 10000);
});
  • Perfect for Jeopardy-style competitions
  • Tests both knowledge and quick reflexes
  • Ideal for sports trivia and general knowledge
  • Supports up to 400 players simultaneously

Quiz Mode: The Deliberate Choice for Deep Learning

Why Four Options, Not Three?

  • Ideal for educational assessments
  • Allows time for careful consideration
  • Provides detailed answer explanations
  • Best for subject-specific testing

Auto Mode: The AI Revolution in Question Generation

The Document Parsing Pipeline

This is what happens when you upload a PDF to Auto Mode:

  1. Text Extraction: Using pdf-lib for PDFs, mammoth for Word docs. We strip headers/footers and normalize formatting.
  2. Chunking: Split text into 500-word segments. Each segment gets processed independently for parallel execution.
  3. Embedding: Convert text to vector embeddings using text-embedding-3-small. This captures semantic meaning.
  4. Question Generation: GPT-4-turbo with a carefully crafted prompt. The prompt asks for 3-5 questions per chunk, ensuring variety.
  5. Validation: Each question is checked for clarity, answer accuracy, and difficulty level distribution.
// AI prompt for question generation
const prompt = `
You are an educational expert creating quiz questions from technical content.
Create 4-5 multiple choice questions that test comprehension, not memorization.
Format: Question | Option A | Option B | Option C | Option D | Correct Answer (A/B/C/D)
Ensure: 1 correct answer, 3 plausible distractors, difficulty rating (1-5)
Content: ${chunk}
`;

const completion = await openai.createCompletion({
  model: "gpt-4-turbo",
  prompt: prompt,
  max_tokens: 500,
  temperature: 0.7
});
  • AI generates questions from your documents
  • Perfect for study guides and practice tests
  • Saves hours of manual question creation
  • Available for educators and students

Choosing the Right Mode: A Decision Framework

🔴 Choose Buzzer For:

  • Competitive events
  • Speed challenges
  • General knowledge

🔵 Choose Quiz For:

  • Detailed assessments
  • Educational testing
  • Subject mastery

🟣 Choose Auto For:

  • Study materials
  • Practice tests
  • AI-powered learning

The Data Pipeline: From Quiz to Insights

Firestore Integration (Real-time)

{
  "sessionId": "mech-2024-001",
  "playerId": "student_123",
  "questionId": "q_456",
  "selectedAnswer": "B",
  "timestamp": firebase.firestore.FieldValue.serverTimestamp(),
  "timeSpent": 12.3
}

Google Sheets (Export)

// Apps Script trigger
function exportToSheets() {
  const data = getQuizResults();
  const sheet = SpreadsheetApp.getActiveSheet();
  data.forEach(row => sheet.appendRow(row));
}