Player Roles¶
The Player Roles page configures the in-game roles that players can be assigned within events. Player roles are distinct from platform roles (Admin, Organizer, Player) — they define a player's function and abilities during gameplay.
Role List¶
The role list displays all configured player roles.
| Column | Description |
|---|---|
| ID | Short identifier (up to 3 characters) |
| Name | Role display name |
| Description | Brief description of the role's function |
| Abilities | Number of abilities assigned to this role |
| Events | Number of events using this role |
Built-In Roles¶
MAGK includes default player roles that cover common tactical scenarios:
| Role | ID | Description |
|---|---|---|
| Rifleman | RFL | Standard infantry role with no special abilities |
| Medic | MED | Can revive downed teammates and extend capture timers |
| Engineer | ENG | Can interact with node devices faster and repair objectives |
| Recon | RCN | Extended visibility radius on the tactical map |
| Commander | CMD | Can issue mission waypoints and view all team positions |
Built-in roles can be customized but not deleted.
Creating a Role¶
Click Create Role to define a new player role.
Form Fields¶
| Field | Type | Required | Description |
|---|---|---|---|
| ID | Text | Yes | Short identifier, up to 3 characters (e.g., SNP) |
| Name | Text | Yes | Role display name |
| Description | Textarea | No | Description shown to players when selecting roles |
| Icon | Select | No | Icon displayed on the tactical map and roster |
| Color | Color | No | Role color used in the UI and map markers |
Role Abilities¶
Each role can have one or more abilities that modify gameplay behavior. Configure abilities from the role detail view under the Abilities tab.
| Ability | Description |
|---|---|
| Fast Capture | Reduces objective capture time by a percentage |
| Extended Range | Increases the interaction radius for objectives |
| Map Vision | Reveals additional information on the tactical map |
| Revive | Can restore downed teammates to active status |
| Repair | Can restore destroyed objectives to active status |
| Stealth | Position is hidden from opposing teams on the map |
| Waypoint | Can place waypoint markers visible to the team |
Adding an Ability¶
Click Add Ability in the abilities tab, select the ability type, and configure its parameters (e.g., capture time reduction percentage, range multiplier).
Role Assignment¶
Players are assigned roles within their team roster. Role assignment can happen in several ways:
| Method | Description |
|---|---|
| Admin Assignment | Admins or organizers assign roles from the Teams roster view |
| Player Selection | Players choose their role during registration (if enabled in event settings) |
| Auto-Assign | Roles are distributed automatically based on configured ratios |
Role Limits¶
Optionally limit how many players per team can hold a specific role:
| Setting | Description |
|---|---|
| Max Per Squad | Maximum players with this role per squad |
| Max Per Platoon | Maximum players with this role per platoon |
| Ratio | Target percentage of the team that should have this role (for auto-assign) |
Configure role limits from the role detail view under the Limits tab.
Related Pages¶
- Events — Roles are used within events
- Teams — Role assignment happens in team rosters
- Registrations — Players may select roles during registration
- Scoring — Some scoring rules may apply to specific roles