FlexMatch integration with Amazon GameLift hosting - Amazon GameLift
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

FlexMatch integration with Amazon GameLift hosting

FlexMatch is available with the managed Amazon GameLift hosting for custom game servers and Realtime Servers. To add FlexMatch matchmaking to your game, complete the following tasks.

  • Set up a matchmaker. A matchmaker receives matchmaking requests from players and processes them. It groups players based on a set of defined rules and, for each successful match, creates a new game sessions and player sessions. Follow these steps to set up a matchmaker:

    • Create a rule set. A rule set tells the matchmaker how to construct a valid match. It specifies team structure and specifies how to evaluate players for inclusion in a match. See these topics:

    • Create a game session queue. A queue locates the best region for each match and creates a new game session in that region. Use an existing queue or create a new one for matchmaking. See this topic:

    • Set up notifications (optional). Since matchmaking requests are asynchronous, you need a way to track the status of requests. Notifications is the preferred option. See this topic:

    • Configure a matchmaker. Once you have a rule set, queue, and notifications target, create the configuration for your matchmaker. See these topics:

  • Integrate FlexMatch into your game client service. Add functionality to your game client service to start new game sessions with matchmaking. Requests for matchmaking specify which matchmaker to use and provide the necessary player data for the match. See this topic:

  • Integrate FlexMatch into your game server. Add functionality to your game server to start game sessions that are created through matchmaking. Requests for this type of game session include match-specific information, including players and team assignments. The game server needs to access and use this information when constructing a game session for the match. See this topic:

  • Set up FlexMatch backfill (optional). Request additional player matches to fill open player slots in existing games. You can turn on automatic backfill to have Amazon GameLift manage backfill requests. Or you can manage backfill manually by adding functionality to your game client service or game server to initiate match backfill requests. See this topic:


    FlexMatch backfill is currently not available for games using Realtime Servers.