Queue Prioritization

Everything you need to know about queue prioritization or "priority queueing" in the Mineplex Studio

By default, when a player joins a game server that is at capacity, they are placed in a queue to wait for a spot to open up. The player at the front of the queue is the next player to join the game server when a spot becomes available.

Note:

  • Because the Mineplex Studio queuing service is a large distributed system, the queue position and size metrics that are exposed to players are not necessarily deterministic, and may have slight inaccuracies due to eventual consistency

Default Priority Calculation 🔗

By default, every player has a queue priority of 1.0. Parties are assigned the average priority of all their members, with a slight bonus of up to 1.0 total points based on the size of the party.

As a player waits in the queue, they accumulate an additional 1.0 priority every minute. This means that the longer a player waits in the queue, the higher their priority becomes. Priorities can never be negative and are capped at 100.0.

Custom Priorities ("Priority Queueing") 🔗

The base priority of a given player can be customized. This is useful for creating special products or subscriptions that grant players priority access to a game server's queue. It is possible to set a player's priority value for a given project from either the Matchmaker API or via the Purchases SDK through a Managed Entitlement.

When picking priority values for custom products or subscriptions, we recommend considering the following:

  • Each point beyond 1.0 represents roughly a minute of queue time that the player will "skip" in position when joining a game server
  • The maximum priority value is 100.0, which represents a player who has waited in the queue for 100 minutes
  • Note that players with a custom priority still accrue the default 1.0 priority per minute while waiting in the queue