Skip to content

Events

The Events page is the central hub for creating, configuring, and managing events on the MAGK platform. Events are the top-level organizational unit — they contain teams, missions, objectives, scoring rules, and registrations.

Event List

The event list displays all events in a searchable, sortable table.

Column Description
Name Event display name
Status Current lifecycle status (Draft, Registration Open, Registration Closed, Staging, Active, Paused, Completed, Cancelled)
Start Date Scheduled start date and time
End Date Scheduled end date and time
Participants Number of registered players
Location Event location name or coordinates

Filter events by status using the status tabs above the table. Use the search bar to find events by name.

Creating an Event

Click Create Event to open the accordion-based event creation form. The form is organized into collapsible sections so you can see all available configuration at a glance without scrolling through a massive form.

Accordion Sections

Section Description
Event Details Name, description, dates, location (with map picker), event image, and icon color mode
Teams Select which teams participate in this event. Shows checkbox cards with team name and color swatch.
Missions View missions linked to this event. Use + Create Mission to add new ones.
Objectives View objectives linked to this event. Use + Create Objective to add new ones.
Overlays View map overlays linked to this event. Use + Create Overlay to add new ones.
Data Packages View data packages for this event. Use + Upload Package to add new ones.

Draft Auto-Save

All form fields are automatically saved to your browser's local storage as you type. If your session expires or the browser crashes, your progress will be restored when you return.

Map Picker

The Event Details section includes a map picker with geocoding search, click-to-place, and manual latitude/longitude inputs. You can type exact coordinates to place the event marker at a known position.

Editing an Event

Click any event row to open the event edit page. The page has:

  1. Header — Event title with Roster, Mission Workflow, and Resources navigation buttons
  2. Status Section — Current status badge, transition buttons, and admin override
  3. Accordion Form — All editable event fields organized into the same sections as the create form, pre-populated with existing data. Missions, objectives, overlays, and data packages linked to the event are shown with counts and "View" links.

Event Lifecycle

Events progress through eight statuses:

graph LR
    D[Draft] -->|Open Registration| RO[Registration Open]
    D -->|Begin Staging| S[Staging]
    D -->|Activate| A[Active]
    RO -->|Close Registration| RC[Registration Closed]
    RC -->|Begin Staging| S
    RC -->|Activate| A
    S -->|Activate| A
    A -->|Pause| P[Paused]
    A -->|Complete| C[Completed]
    P -->|Resume| A
    P -->|Complete| C
    D -->|Cancel| X[Cancelled]
    RO -->|Cancel| X
    RC -->|Cancel| X
    S -->|Cancel| X
    A -->|Cancel| X
    P -->|Cancel| X

Status Descriptions

Status Description
Draft Default for new events. Visible only to Admins and Organizers. Configure teams, missions, and objectives.
Registration Open Players can register for the event.
Registration Closed Registration window has ended.
Staging Pre-event setup phase for final checks — verify team assignments, test node connectivity.
Active Event is live. Scoring and node capture mechanics are active. Public live page accessible.
Paused Temporarily suspends scoring and node interactions. Event remains visible.
Completed Event has ended. Final scores preserved as historical record.
Cancelled Event cancelled. Removed from public listings but retained in admin view.

Changing Status

The event edit page has a dedicated status section with colored transition buttons. All transitions require confirmation. Admin Override allows setting any status directly (logged as event.status_force_change).

Voice Communications

Enable Mumble voice channels for an event in the Communications settings tab.

Enabling Mumble

  1. Navigate to the event's edit page
  2. Open the Communications tab
  3. Check Enable Mumble Voice
  4. Save the event

Note

The Mumble server must be enabled at the platform level (MUMBLE_ENABLED=true) before per-event voice can be configured. See Voice Communications for platform setup.

Channel Provisioning

Mumble channels are automatically created when the roster is finalized:

  • One channel per squad (e.g., "Alpha Squad")
  • One channel per platoon (e.g., "1st Platoon")
  • One root event channel (e.g., "Operation Sunrise")
  • One admin channel (restricted to admin/organizer roles)

Each channel has ACLs that restrict access to members of the corresponding organizational unit.

Channel Modes

Mode Behavior
Roster-Based Full hierarchy (Root → Platoons → Squads + Admin channel) created during finalization
Admin Channel Only Single root channel with an Admin sub-channel — no squad hierarchy

Player Notifications

After provisioning, players can be notified of their Mumble configuration via:

  • Email — Contains server address, port, username, and channel assignment
  • QR Code — Updated with Mumble connection details for ATAK enrollment
  • Data Package — TAK data packages include Vx plugin configuration for automatic voice setup

Deprovisioning

To remove provisioned channels:

  1. Navigate to the event's Communications section
  2. Click Deprovision Channels
  3. Confirm the action

This removes all Mumble channels for the event and resets the provisioning state.