Create a Amazon GameLift Anywhere fleet

Get the authentication token for your compute resource from the fleet that you created.

Your game server uses the authentication token to authenticate with Amazon GameLift. Each authentication token has an expiration token. To continue using the compute resource to host your game server, retrieve a new authentication token before the expiration.

In the following example, replace the fleet-id with the ARN or fleet ID of the fleet created in the previous steps. Replace the compute-name with the name of the compute you created using the register-compute command in a previous step.

aws gamelift get-compute-auth-token \
    --fleet-id arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-cebb4da2-52a8-4c27-9b85-587f945c6445 \
    --compute-name HardwareAnywhere

Example output:

{
    "FleetId": "fleet-cebb4da2-52a8-4c27-9b85-587f945c6445",
    "FleetArn": "arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-cebb4da2-52a8-4c27-9b85-587f945c6445",
    "ComputeName": "HardwareAnywhere",
    "ComputeArn": "arn:aws:gamelift:us-east-1:111122223333:compute/HardwareAnywhere",
    "AuthToken": "0c728041-3e84-4aaa-b927-a0fb202684c0",
    "ExpirationTimestamp": "2023-02-23T18:47:54+00:00"
}

Run an instance of your game server executable.

To run your game server, initialize your game server by calling InitSDK() and passing it your server parameters. For more information about server parameters, see ServerParameters.

Server SDK input:

//Define the server parameters
ServerParameters serverParameters = new ServerParameters(
    webSocketUrl=wss://us-east-1.api.amazongamelift.com,
    processId=PID1234,
    hostId=HardwareAnywhere,
    fleetId=arn:aws:gamelift:us-east-1:111122223333:fleet/fleet-cebb4da2-52a8-4c27-9b85-587f945c6445,
    authToken=0c728041-3e84-4aaa-b927-a0fb202684c0);

//InitSDK establishes a connection with GameLift's websocket server for communication.
var initSDKOutcome = GameLiftServerAPI.InitSDK(serverParameters);

After the server process is ready to host a game session, call ProcessReady() from your game server to Amazon GameLift. For more information about process parameters, see ProcessParameters

// Set parameters and call ProcessReady
var processParams = new ProcessParameters(
   this.OnStartGameSession,
   this.OnProcessTerminate,
   this.OnHealthCheck,
   this.OnUpdateGameSession,
   port=1024,
   new LogParameters(new List<string>()          // Examples of log and error files written by the game server
   {
      "C:\\game\\logs",
      "C:\\game\\error"
   })
);

var processReadyOutcome = GameLiftServerAPI.ProcessReady(processParams);

Add logic to your game server so that your server process responds to the onStartGameSession() message with ActivateGameSession(). This operation has no parameters, but it sends an acknowledgement to Amazon GameLift that your server received and accepted the create game session message.

void OnStartGameSession(GameSession gameSession)
{
    // game-specific tasks when starting a new game session, such as loading map   

    // When ready to receive players   
    var activateGameSessionOutcome = GameLiftServerAPI.ActivateGameSession();
}

From your game client backend service, start your game session using the start-matchmaking, start-game-session-placement, or create-game-session command.

aws gamelift create-game-session \
    --fleet-id arn:aws:gamelift:us-east-1:682428703967:fleet/fleet-cebb4da2-52a8-4c27-9b85-587f945c6445 \
    --name GameSession1 \
    --maximum-player-session-count 2 \
    --location custom-location-1

Example output:

GameSession {
  FleetId = arn:aws:gamelift:us-east-1:682428703967:fleet/fleet-cebb4da2-52a8-4c27-9b85-587f945c6445,
  GameSessionId = 4444-4444,
  Name = GameSession1,
  Location = custom-location-1,
  IpAddress = 10.2.3.4,
  Port = 1024,
  ...
}

Amazon GameLift sends an onStartGameSession() message to your registered server process. The message contains the GameSession object from the previous step with game properties, game sessions data, matchmaker data, and more about the game session.

When the game session is complete, end the game server process.

Server SDK input:

var processEndingOutcome = GameLiftServerAPI.ProcessEnding();
if (processReadyOutcome.Success)
   Environment.Exit(0);
// otherwise, exit with error code
Environment.Exit(errorCode);

Start another game server process by calling ProcessReady(processParams).