Team Event Leaderboards

Team Event Leaderboards bring the Event Leaderboard system to team-based play. Instead of individual players competing in cohorts, teams compete as units: members contribute scores individually, and the team’s total determines its cohort ranking and tier progression.

Everything in the base system applies to Teams, including time-based and score-based events, cohort matchmaking, tier progression, and reward distribution. See Event Leaderboards for a full overview of how the system works.

What teams can do #

  • List: View available events, optionally filtered by category
  • Get: Retrieve a specific event, including team standings, scores, and individual member contributions
  • Roll: Enrol a team into a cohort for an event, with tier-based matchmaking
  • Update: Submit scores as individual team members, contributing to the team’s total
  • Claim: Collect rewards after an event ends, based on final team ranking and tier placement

Key terms #

Cohorts: Teams compete in small groups, typically 10–50 players, which are locked when full. The system finds existing cohorts with available slots or creates new ones as needed.

Tier-based matchmaking: Teams only compete against others in their skill tier. Progression between tiers follows configurable promotion and demotion rules.

Individual contributions: While teams compete as units, each member’s score contributions are tracked separately. This lets you recognize top contributors and ensures team scores reflect actual member participation.

Example: Seasonal team leagues #

A weekly league gives teams a recurring reason to coordinate. Teams are placed into cohorts of 15 within their tier, like Bronze, Silver, Gold, or Diamond, and compete throughout the week. Members contribute by completing missions, winning PvP matches, or crafting items, with individual scores aggregating into a team total.

At the end of each week, top-performing teams advance to higher tiers with better rewards; struggling teams may be demoted. Teams that miss multiple weeks face automatic demotion, keeping matchmaking fair for active participants.

Score-based events #

Team Event Leaderboards also support score-based events, where teams race to reach a target score rather than competing over a fixed time window. When a team hits the target, the cohort completes and the team can claim rewards and immediately roll into a new cohort with fresh opponents, all within the same phase. This enables fast-paced, repeatable competitive loops for teams.

For a full overview of score-based events, including multi-rolling within a single phase, re-roll mechanics, cohort completion rules, and configuration examples, see Score-based events.

Technical considerations #

Demotion for inactivity #

Teams that miss multiple event iterations face cumulative tier drops up to a configured maximum limit.

Event state #

Events maintain state flags (IsActive, CanClaim, CanRoll) that determine available operations. Teams can’t update scores after events end or claim rewards before events conclude.