Skip to content

Live Event View

The public live event page provides a real-time view of an active MAGK event. It is accessible without authentication, allowing spectators and participants to follow event progress.

Page Location

  • URL: /events/:eventSlug/live
  • Access: Public (unauthenticated)

Purpose

The live event view gives spectators and participants a read-only window into an active event. It displays the tactical map, team scores, and event status without requiring a login.

Layout

The page is divided into two main areas:

  • Tactical Map — A live map showing team positions, objectives, and event boundaries
  • Scoreboard — A real-time leaderboard displaying team scores and rankings

On mobile devices, the map fills the viewport with the scoreboard accessible via a toggle or bottom sheet.

Tactical Map

The map displays:

Element Description
Team markers Color-coded markers showing team positions
Objectives Mission objective locations with capture status
Event boundary The defined mission area or geofence
Overlays Any organizer-configured map overlays

Map data updates in real time via WebSocket. The map supports zoom, pan, and layer switching (street, satellite, hybrid) depending on configured map providers.

Visibility

The live event view shows only information the organizer has marked as publicly visible. Sensitive tactical data may be hidden from the public view.

Scoreboard

The scoreboard shows:

  • Team names and colors
  • Current point totals
  • Ranking order
  • Objective capture counts (if enabled)

Scores update in real time as capture events and scoring actions occur during the event.

Event Status

The page header displays the current event status:

Status Meaning
Draft Event is being configured — not yet visible to players
Registration Open Players can register for the event
Registration Closed Registration deadline has passed
Staging Pre-event setup in progress
Active Event is currently in progress
Paused Event is temporarily paused
Completed Event has ended — final scores are displayed
Cancelled Event was cancelled