Amazon GameLift
Developer Guide (Version )

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.

Get Started with Custom Servers

This roadmap outlines the key steps to getting your multiplayer games with custom game servers up and running on GameLift. If you're interested in using GameLift Realtime Servers, which lets you deploy your game client with our ready-to-deploy game servers, see Get Started with Realtime Servers.

New to GameLift? We recommend that you read What Is Amazon GameLift? If you're unsure whether GameLift supports your operating systems and development environments, see the topics Amazon GameLift SDKs and Game Engines and Amazon GameLift.

Before you start integration, you need to have an AWS account and configure it for Amazon GameLift. Learn more at Set Up an AWS Account. All essential tasks related to creating and managing your game servers can be done using the Amazon GameLift console, but you may also want to Get and install the AWS Command Line Interface tool.

  1. Prepare your custom game server for hosting on Amazon GameLift.

  2. Prepare your game client to connect to Amazon GameLift-hosted game sessions.

    • Set up a client service to communicate with Amazon GameLift service in order to start game sessions and place players into games when prompted by a game client.

      • Add the AWS SDK to your client service project. See the Amazon GameLift SDKs For Client Services.

      • Add functionality to retrieve information on game sessions, place new game sessions and (optionally) reserve space for players on a game session. See Add Amazon GameLift to Your Game Client. Recommended: Use game session placements to take advantage of FleetIQ and optimize resource usage and player experience. This option is required if you're using FlexMatch.

      • (optional) Enable the client service to request player matchmaking using FlexMatch. Learn more in FlexMatch Integration Roadmap.

    • Enable your game client to connect directly with a hosted game session. Add code to acquire connection information for a game session and (optionally) a reserved player session. Use this connection information and a unique player ID to communicate with the game server and join the game. See Join a Player to a Game Session.

  3. Test your Amazon GameLift integration.

    • Use Amazon GameLift Local to test your game client and game server integration using a version of the Amazon GameLift service running locally. You can use this tool to test your integration without having to upload game builds and set up fleets. You can verify that your game components are communicating with the Amazon GameLift service, and test core functionality. See Testing Your Integration.

  4. Build a fleet of computing resources to host your game.


    Once you've created your queues, you'll need to update your client service to use the correct queue ID when requestion game session placements and/or matchmaking.

Once you've fully integrated Amazon GameLift into your game components, it's a matter of managing your game server fleets for optimal availability and performance over the long term. Use Amazon GameLift tools to track things like how quickly and efficiently players can find and connect to a game session, overall performance of your game servers over time, and player usage patterns. See Viewing Your Game Data in the Console.