Note: The content on this page pertains to Game Server Hosting (Multiplay) available on the Unity Dashboard. If you’re using Game Server Hosting (Clanforge), see the Game Server Hosting (Clanforge) documentation.

An allocation is a request to Game Server Hosting from a matchmaker for the best possible server for a game match. The allocation system works with a matchmaker and QoS to connect a group of players to the best possible server for the game session while taking into account:

Note: You can also use the Allocations Payload feature to send a file to a server along with the allocation request.

The allocation flow looks something like this:

  1. The matchmaker groups players for a game session.
  2. The matchmaker requests an allocation from the Game Server Hosting (Multiplay) API, and Game Server Hosting queues the allocation request.
  3. Game Server Hosting asynchronously finds the best server for the game session based on the parameters of the allocation request.
  4. Game Server Hosting removes the selected server from the available servers pool and marks it as allocated.
  5. Game Server Hosting applies configurations from the build configuration to the server and ensures the server is ready.
  6. Game Server Hosting returns the server information to the matchmaker when the server is ready.