Multiplayer Gem CVars

For convenience, the Multiplayer Gem provides the following console variable commands that you can use to test features or configurations.

Client CVars

mphost <port number>

Creates a GridSession using the LANSessionService on the local machine. The optional port number determines the port on which the grid session runs.

mpjoin <server address> <port number>

Performs a GridSearch using the LANSessionService and joins the first session returned. The server address and port number are optional parameters that can be used to refine the GridSearch.

mpsearch

Performs a GridSearch using the LANSessionService.

mpdisconnect

Disconnects the local client from its active GridSession, if any.

gm_version

Sets the GridMate version number.

gm_netsec_enable

Specifies whether network level encryption is used for connections. A value of 0 disables encryption and a value of 1 enables encryption. The default for the multiplayer gem is 0 (disabled).

Note

In the Multiplayer Sample, this value is overridden to be enabled in game.cfg.

gm_netsec_private_key

Specifies the private key file (PEM format) for a secure network connection when FileDataSource is used as a certificate manager. This setting overrides any previously configured values in FileDataSource. If network encryption is enabled, this value must be set on the host of a GridSession when the session is created. This setting is disabled in release builds.

gm_netsec_certificate

Specifies the private key file (PEM format) for a secure network connection when FileDataSource is used as a certificate manager. This setting overrides any previously configured values in FileDataSource. If network encryption is enabled, this value must be set on the host of a GridSession when the session is created. This setting is disabled in release builds.

gm_netsec_ca

Specifies the CA Certificate file (PEM format) for a secure network connection when the FileDataSoruce is used as a certificate manager. This setting overrides any previously configured values in FileDataSource. This value must be set on the client when trying to join a GridSession using encryption. This setting is disabled in release builds.

gm_netsec_verify_client

Enables client verification. If not enabled, only the server is authenticated. Must be set on the host of a GridSession. The default is 0, disabled.

gm_disconnectDetection

Sets whether disconnect detection is enabled for a particular GridSession. Must be set on the host of GridSession. If disconnect detection is enabled, clients that do not respond to inquiries within the timeout window are disconnected. The default is 1, enabled.

gm_disconnectDetectionRttThreshold

A RTT threshold, in milliseconds, that specifies the time after which a connection is dropped when there is no response. The default is 500.

gm_disconnectDetectionPacketLossThreshold

A value between 0 and 1 that represents the percentage of packets that are permitted to be lost in communication with a particular client. If a client experiences a packet loss greater than the specified value, the connection is dropped. The default is 0.3.

gm_recvPacketsLimit

The maximum number of packets per second allowed to be received from an existing connection. The default is 0 (no limit).

gm_ipversion

Specifies which Internet protocol version to use. Possible values are IPv4 or IPv6. The default is IPv4.

gm_securityData

Specifies the security data for session.

gm_replicasSendTime

Specifies, in milliseconds, the time interval between replica updates. A value of 0 binds the interval to the GridMate tick rate. The default is 0.

gm_replicasSendLimit

Limits the amount of replica data sent per second. 0 specifies no limit. The default is 0. This value is disabled in release builds.

gm_burstTimeLimit

Specifies, in seconds, an interval window during which bandwidth capping is not applied. If bandwidth usage continues to exceed the replica send limit outside of this interval, the sent amount is capped at the send limit. The default is 10. This variable is disabled in release builds.

gamelift_fleet_id

Specifies the GameLift FleetId to use for this client when starting GameLiftSessionService.

gamelift_aws_access_key

Specifies the AWS access key associated with the GameLift fleet.

gamelift_aws_secret_key

Specifies the AWS secret key associated with the GameLift fleet.

gamelift_aws_region

Specifies the AWS region associated with the GameLift fleet. The default is us-west-2.

gamelift_endpoint

Specifies the GameLift service endpoint. The default is gamelift.us-west-2.amazonaws.com.

gamelift_alias_id

Specifies the GameLift alias ID to use with the client.

gamelift_player_id

Specifies the GameLift player ID associated with the client.

gamelift_stop_client

Stops the GameLiftSessionService and terminates the current GridSession, if one is connected.

gamelift_queue_name

Specifies GameLift queue to use for this client when creating or joining a game session.

gamelift_matchmaking_config_name

Specifies GameLift FlexMatch matchmaking configuration to use for this client when being placed in a game session.

sv_port <local_port>

Sets the local UDP port that initializes the socket. The default port is 30090. To use the ephemeral port, set the port to 0. This is useful if you want to connect to a server on the same computer as the client.

Server CVars

gamelift_flexmatch_enable

Configures the server process to enable custom matchmaking backfill for FlexMatch.

gamelift_flexmatch_onplayerremoved_enable

Configures the server process to start matchmaking backfill on players removed and if an empty slot is available.

gamelift_flexmatch_start_delay

Delay to add to start matchmaking backfill on new game session create.

gm_netsec_enable

Specifies whether network level encryption is used for connections. A value of 0 disables encryption and a value of 1 enables encryption. The default for the multiplayer gem is 0 (disabled).

Note

In the Multiplayer Sample, this value is overridden to be enabled in game.cfg.