capabilities.work

Set Up and Run FlexMatch Matchmaking

A 4-step recipe with Amazon GameLift. We can help you get access.

Recipe · 4 steps

Set Up and Run FlexMatch Matchmaking

with Amazon GameLift

Create a rule set and configuration, start matchmaking, and poll the ticket.

  1. Create a matchmaking rule set from the supplied JSON rule body. The configuration created next references this rule set by name.
  2. Create a matchmaking configuration that uses the new rule set. The configuration governs how players are grouped and how matched sessions are started.
  3. Start a matchmaking ticket for the supplied players using the new configuration. The ticket begins in QUEUED status.
  4. Describe the matchmaking ticket and check its status. Repeat while QUEUED or SEARCHING; finish once the ticket is COMPLETED or REQUIRES_ACCEPTANCE.
What you'll need to have ready
  • ruleSetName: A unique identifier for the matchmaking rule set.
  • ruleSetBody: The matchmaking rules formatted as a JSON string.
  • configurationName: A unique identifier for the matchmaking configuration.
  • requestTimeoutSeconds: Maximum seconds a matchmaking ticket can remain in process before timing out.
  • acceptanceRequired: Whether matched players must accept the proposed match.
  • gameSessionQueueArns: Optional list of game session queue ARNs to place matched sessions into.
  • players: List of players to match, each with a player ID and optional attributes/latency.
For your developer

Arazzo workflow amazon-gamelift:setup-matchmaking, 4 operations: CreateMatchmakingRuleSet → CreateMatchmakingConfiguration → StartMatchmaking → DescribeMatchmaking. Specs on APIs.io.

More recipes with Amazon GameLift

Stand Up a Fleet Behind an AliasCreate and Resolve a Fleet AliasDeploy Build to a FleetFill a Game Session with PlayersHost a Game Session and Add a PlayerMatchmaking with Player AcceptanceOpen Fleet Ports then Host a SessionQueue-Based Game Session PlacementScale Fleet CapacitySearch for a Game Session and Join It