🏆 TOP 5 PLAYERS

This is a 5-totem quiz kiosk system for the FedEx UEFA Champions League activation. Each totem runs independently on a portrait touchscreen (1080×1920) and connects to a shared SQLite database.

Players enter an alphanumeric code at any totem, answer timed trivia questions, and aim to complete all 5 totems for the highest score. A bonus team prediction round unlocks after all 5 totems are completed during the First Half.

The system supports three quiz modes (1st Half, 2nd Half, Free Play) that switch automatically based on configurable time schedules.

Base points: 100 points per correct answer

Speed bonus: Up to 50 extra points based on answer speed

Formula: points = 100 + round((timer - seconds) / timer × 50)

Example (10s timer): Answer in 2s = 100 + 40 = 140 points

Example (10s timer): Answer in 8s = 100 + 10 = 110 points

Wrong answer or time expired = 0 points

Timer: Configurable in Settings → Quiz Timer (default 10 seconds, options: 5–30s)

Double points: Players who complete all 5 totems during the First Half see a team prediction screen. If they predict the match winner correctly, their total score is doubled when the admin applies it. The prediction round does NOT appear during 2nd Half or Free Play. If the "Include in Double Points" toggle is ON for 2nd Half, those scores are also included in the doubled total. Free Play scores are never doubled.

Three quiz modes run automatically based on time of day:

1st Half — Players enter a code, play the full quiz per kiosk, track totem progress across all 5. Team prediction available after completing all 5 totems.

2nd Half — Same code-based play and totem tracking. No team prediction screen.

Free Play — Post-match casual play. No code required — players tap "PLAY NOW." 4 random questions from the combined 1st + 2nd Half pools. Unlimited plays, no totem tracking, scores shown per session but not saved to the leaderboard.

Each mode has start/end times and an ON/OFF toggle in Settings. Kiosks auto-switch based on time. Between windows, the "Game Closed" screen appears.

Dashboard — Live stats: registered players, free-play sessions, answers, accuracy per kiosk (bar charts), top 10 players (excludes free-play), recent activity, current quiz mode.

Questions — Manage per kiosk and per mode:

• Add/Edit/Delete questions with 2–4 answers

• Reveal text per answer — optional text shown on all buttons after selection (e.g. stats, fun facts)

• Activate/Deactivate individual questions

• Reorder with ▲▼ arrows (fixed order mode only)

• Quiz Length: "All" or a number (1–10) for random selection

• Question Order: Fixed or Randomized

• CSV Import: Bulk upload via CSV. Download template for correct format

• Free Play note: Uses 1st + 2nd Half pools (max 4 random). No separate question bank needed

Settings — Configuration:

• Schedule: start/end times and ON/OFF for each mode

• Team Prediction Round toggle (1st Half)

• Include in Double Points toggle (2nd Half)

• Quiz Timer: 5–30 seconds per question

• Team management, winning team, double points application

• Kiosk assignment (1–5)

Controls —

• Trivia Open/Closed — master switch for all kiosks

• Public Top 5 — shareable link, auto-refreshes, excludes free-play

• Reset Player Totem — let a player replay a specific totem

• Reset All Data — clear all players/scores, keep questions

Question timer: Configurable (default 10s). Expired = incorrect, correct answer + reveal shown for 2s.

Inactivity: 45 seconds → auto-return to home (game screens only).

Results: 5s → totem progress (1st/2nd Half) or home (Free Play).

Totem progress: 5s → home. All-complete: 8s → home.

Mode check: Every 60s. Auto-switches between modes, PIN entry ↔ Free Play.

Public leaderboard: Refreshes every 15s. Notifications: Auto-dismiss 5s.

Blocked: right-click, text selection, pinch/double-tap zoom, pull-to-refresh, overscroll, keyboard shortcuts (F1–F11, Ctrl/Alt+*), image dragging, browser back/forward, double-tap on quiz answers.

Admin: Tap top-left corner → PIN 54321

Restart kiosk: Top-left corner → PIN 1111 → "Restart Kiosk"

Player codes: Alphanumeric (A–Z, 0–9), auto-uppercased. Free Play needs no code.

Totem select: First load picks totem 1–5. Change via Admin → Settings.

Required files:

• images/fedex_logo.png — logo

• images/winbig.png — home screen logo

• fonts/FedExSans_Bd.ttf — Bold (titles)

• fonts/FedExSans_CdBd.ttf — Condensed Bold (body)

• fonts/FedExSans_XBd.ttf — Extra Bold (headings)

• data/ — writable directory (chmod 755)

Fresh reset: Delete data/quiz.db and reload.

Q: Kiosk shows "Game Closed"?

Check: 1) Trivia Open in Controls 2) Current time in a mode window 3) Mode toggled ON

Q: Score seems wrong?

Server-calculated: 100 base + speed bonus. Bonus scales with the configured timer.

Q: No questions showing?

Check active questions for that kiosk + mode. Free Play uses 1st + 2nd Half pools.

Q: Player wants to replay a totem?

Controls → Reset Player Totem → enter code, select totem. Free Play has no lockout.

Q: How does Free Play work?

During Free Play schedule, home shows "PLAY NOW" (no code). 4 random questions from 1st + 2nd Half pools. Scores shown per session, not saved to leaderboard. Unlimited plays.

Q: How to apply double points?

Settings → Set Winner → "Apply 2x Points." Doubles correct predictors' scores. Prediction only in 1st Half. Free Play never doubled.

Q: How to import questions?

Questions tab → CSV Import → download template, fill in, upload. Select kiosk + mode first.

Q: What is reveal text?

Optional text per answer shown on all buttons after selection. Use for stats or fun facts.