Configuration Options #
Core Configurations #
pragma.config.CoreConfig #
Node-Wide Configuration
- Configuration Values:
field description type values/constraints clusterName
The name of the cluster. String minLength: 1 nodeName
The name of the node, to be used in nodeByInstanceId of distributedServices. String minLength: 0 openTelemetryServiceName
Service name for open telemetry tracing. String minLength: 0 logging
Logback configuration options. Object of type LoggingConfig LoggingConfig session
The configuration of a connection through a gateway. Object of type SessionConfig SessionConfig portalUrl
Hostname of the operator Pragma portal web interface. String minLength: 0 enableHistogramMetrics
Enables histograms for metrics. This uses a large number of tags per metric. Boolean options: true
,false
enableKtorMetrics
Enables standard KTOR metrics for HTTP requests. Boolean options: true
,false
metricsDistributionExpiryDurationSeconds
The expiration duration for DistributionStatistics. See https://micrometer.io/docs/concepts#_distribution_summaries for more information. Long min: -9223372036854775808, max: 9223372036854775807 startupTimeoutMillis
The maximum time in milliseconds to wait during startup before forcibly exiting. Long min: 0, max: 9223372036854775807 shutdownTimeoutMillis
The maximum time milliseconds to wait during shutdown before forcibly exiting. Long min: 0, max: 9223372036854775807 gatewayManager
Object that starts or stops player, operator, and partner gateways. Object of type GatewayManagerConfig GatewayManagerConfig distributedServices
Map of services running on each node. Map of Object of type DistributedServiceConfig DistributedServiceConfig remoteNodeConfigs
Map object referencing all remote nodes to their host:port. Map of Object of type RemoteNodeConfig RemoteNodeConfig nettyPendingTasksCheckPeriodMillis
How often to check pending tasks and emit a metric. Long min: -9223372036854775808, max: 9223372036854775807 allowWorkInProgressAccess
Allows access to methods that are works in progress. Boolean options: true
,false
enableVersionWithBuildSlug
Adds a build slug to the version output. Boolean options: true
,false
shardId
The unique uuid of this shard. UUIDv4
pragma.config.LoggingConfig #
Logback configuration.
- Configuration Values:
field description type values/constraints rootLoggerLevel
level of the root logger Enum LogLevel allowed values: OFF
,ERROR
,WARN
,INFO
,DEBUG
,TRACE
,ALL
logFormat
default log format String minLength: 0 consoleLoggerEnabled
enable logging to stdout/stderr Boolean options: true
,false
fileLoggerEnabled
enable logging to file Boolean options: true
,false
fileLoggerCurrentFilename
file name (including path) to use for logs String minLength: 0 fileLoggerRolledFilename
file name (including path) to use for rotated logs String minLength: 0 fileLoggerMaxFileSize
max file size for single log file before it is rolled String minLength: 0 fileLoggerRolledTotalSizeCap
size cap of all rolled compressed log files String minLength: 0 loggers
logback log level per logger Map of Enum LogLevel allowed values: OFF
,ERROR
,WARN
,INFO
,DEBUG
,TRACE
,ALL
logLayout
type of layout to log Enum LogLayout allowed values: TEXT
,JSON
pragma.session.SessionConfig #
Session configuration.
- Configuration Values:
field description type values/constraints httpExpirySeconds
expiry length for HTTP sessions, expiration deadline is refreshed on each use of an existing session Long min: -9223372036854775808, max: 9223372036854775807
pragma.config.GatewayManagerConfig #
Available gateways on this node.
- Configuration Values:
field description type values/constraints player
whether the player gateway is enabled on this node Boolean options: true
,false
operator
whether the operator gateway is enabled on this node Boolean options: true
,false
partner
whether the partner gateway is enabled on this node Boolean options: true
,false
pragma.config.DistributedServiceConfig #
Distributed services configuration.
- Configuration Values:
field description type values/constraints nodeByInstanceId
map of instances of distributed services and the node they are running on Map of String minLength: 0
pragma.config.RemoteNodeConfig #
Individual PragmaNodes and their gateway ports configuration.
- Configuration Values:
field description type values/constraints host
the host that the node is running on String minLength: 0 port
the port that the remote node is listening on Int min: -2147483648, max: 2147483647
Service Configurations #
pragma.gamedata.GameDataServiceConfig #
GameDataService configuration.
- Configuration Values:
field description type values/constraints loginDataCollectionTimeout
Time, in milliseconds, to wait to aggregate login data Long min: -9223372036854775808, max: 9223372036854775807
pragma.gateway.SocialPlayerGatewayConfig #
Social Player gateway configuration.
- Configuration Values:
field description type values/constraints protocol
protocol of the host/port String minLength: 0 webSocketProtocol
protocol of the WebSocket host/port String minLength: 0 authenticateHost
authentication backend host String minLength: 0 authenticatePort
authentication backend port Int min: 1, max: 65536 socialHost
social backend host advertised to clients String minLength: 0 socialPort
social backend port advertised to clients Int min: 1, max: 65536 socialBindPort
social backend port the backend binds to (if 0, defaults to socialPort) Int min: 0, max: 65536 devLoginQueueBypass
Enable to bypass login queue token validation during player authentication or creation. Boolean options: true
,false
demo.echo.EchoServiceConfig #
Echo service configuration.
- Configuration Values:
field description type values/constraints
pragma.auth.TokenSignerConfig #
Token Signer configuration.
- Configuration Values:
field description type values/constraints partnerExpirationHours
length of time the partner token is valid for (hours) Long min: -9223372036854775808, max: 9223372036854775807 operatorExpirationMinutes
length of time the operator token is valid for (minutes) Long min: -9223372036854775808, max: 9223372036854775807 emailTokenExpirationMinutes
length of time the email validation token is valid for (minutes) Long min: -9223372036854775808, max: 9223372036854775807 playerTokenExpirationMinutes
length of time the player token is valid for (minutes) Double min: 4.9E-324, max: 1.7976931348623157E308 playerTokenRefreshMinutes
time before the player token expires that we tell clients to refresh Long min: -9223372036854775808, max: 9223372036854775807 playerTokenRefreshVarianceWindowMinutes
variance in refresh time to smooth the refresh load over time Long min: -9223372036854775808, max: 9223372036854775807 jwtPrivateKey
private key used to signed JWTs EncryptedString minLength: 1
pragma.account.config.GameDaoConfig #
GameDaoNodeService configuration.
- Configuration Values:
field description type values/constraints databaseConfig
database config for the game dao Object of type UnpartitionedDatabaseConfig UnpartitionedDatabaseConfig
pragma.auth.TokenDecoderConfig #
Token validator service configuration.
- Configuration Values:
field description type values/constraints jwtPublicKey
JWT used to validate String minLength: 1
pragma.inventory.InventoryServiceConfig #
Inventory service configuration.
- Configuration Values:
field description type values/constraints enableDeleteAllInventory
Determines whether to allow making a cache/db delete call. Boolean options: true
,false
enableDeletePlayerInventory
Determines whether to allow players to delete their inventory. Boolean options: true
,false
legacyItemLoadBehavior
If true, do not filter out items with invalid catalogId when retrieving items. Boolean options: true
,false
contentAccessByTags
Content filtering on player endpoints by tags. Object of type ContentAccessByTagsConfig ContentAccessByTagsConfig inventoryCacheConfig
Config for inventory data cache. Object of type InventoryCacheConfig InventoryCacheConfig
pragma.account.AccountServiceConfig #
Account service configuration.
- Configuration Values:
field description type values/constraints gameManagementPollingFrequencyInMillis
frequency with which Account service checks for updated game management data Long min: -9223372036854775808, max: 9223372036854775807 verificationEmailEndpoint
URL to send the verification email requests to, which is passed into the email sender plugin when templating your email String minLength: 0
pragma.loginqueue.LoginQueueServiceConfig #
Factory for login queue behavior, driven by a feature toggle
- Configuration Values:
field description type values/constraints targetCcuLimit
the target maximum number of concurrent users logged in Int min: 0, max: 2147483647 targetLoginRatePerSecond
the target number of users to log in per second Int min: 0, max: 2147483647 estimatedSecondsToLogin
the time between a user login request and the user gaining access Int min: 0, max: 2147483647
pragma.inventory.InventoryDaoConfig #
InventoryDaoConfig configuration.
- Configuration Values:
field description type values/constraints databaseConfig
database config for the inventory dao Object of type PartitionedDatabaseConfig PartitionedDatabaseConfig
pragma.gameinstance.GameInstanceServiceConfig #
Configuration for the Game Instance Service
- Configuration Values:
field description type values/constraints gameReadyTimeoutMillis
Time, in milliseconds, to wait for a game server to send a connect players request before releasing the players attached to the game instance. Long min: -9223372036854775808, max: 9223372036854775807 enableAbsoluteTimeout
Enables the absolute timeout that will release a game from the service after a specific amount of time has elapsed. Boolean options: true
,false
absoluteTimeoutMillis
Time, in milliseconds, to wait before releasing a game instance. 0 or negative values means games will never timeout. Will be ignored if enableAbsoluteTimeout is false. Long min: -9223372036854775808, max: 9223372036854775807 enableKeepAlive
Enables the keep alive interval requiring game servers to send a keep alive request in a specified interval or else the game instance will be released from the service. Boolean options: true
,false
keepAliveIntervalMillis
Interval, in milliseconds, to wait between keep alive requests. This interval gets passed to the game server. Will be ignored if enableKeepAlive is false. Long min: -9223372036854775808, max: 9223372036854775807 keepAliveMissesLimit
Number of keep alive request misses before releasing the game instance from the service. Will be ignored if enableKeepAlive is false. Long min: -9223372036854775808, max: 9223372036854775807 reconnect
Set to required, optional, or off to determine the player client behavior when recovering from an unexpected disconnect during a game. Enum GameInstanceReconnect allowed values: OFF
,REQUIRED
,OPTIONAL
pragma.gateway.GameOperatorGatewayConfig #
Game Operator gateway configuration.
- Configuration Values:
field description type values/constraints protocol
protocol of the host/port String minLength: 0 webSocketProtocol
protocol of the WebSocket host/port String minLength: 0 authenticateHost
authentication backend host String minLength: 0 authenticatePort
authentication backend port Int min: 1, max: 65536 socialHost
social backend host advertised to clients String minLength: 0 socialPort
social backend port advertised to clients Int min: 1, max: 65536 socialBindPort
social backend port the backend binds to (if 0, defaults to socialPort) Int min: 0, max: 65536 gameHost
game backend host advertised to clients String minLength: 0 gamePort
game backend port advertised to clients Int min: 1, max: 65536 gameBindPort
game backend port the backend binds to (if 0, defaults to gamePort) Int min: 0, max: 65536 sdkCoreEnabled
temporary feature toggle for Core SDK until it is stable Boolean options: true
,false
pragma.account.config.AccountDaoConfig #
AccountDaoNode service configuration.
- Configuration Values:
field description type values/constraints databaseConfig
database config for the account dao Object of type UnpartitionedDatabaseConfig UnpartitionedDatabaseConfig
pragma.playerdata.PlayerDataServiceConfig #
Configuration for the Echo Service
- Configuration Values:
field description type values/constraints
pragma.payment.PaymentDaoConfig #
Configuration for the PaymentDaoNodeService
- Configuration Values:
field description type values/constraints databaseConfig
the database config for the payment dao Object of type PartitionedDatabaseConfig PartitionedDatabaseConfig
pragma.gateway.SocialOperatorGatewayConfig #
Social Operator gateway configuration.
- Configuration Values:
field description type values/constraints protocol
protocol of the host/port String minLength: 0 webSocketProtocol
protocol of the WebSocket host/port String minLength: 0 authenticateHost
authentication backend host String minLength: 0 authenticatePort
authentication backend port Int min: 1, max: 65536 socialHost
social backend host advertised to clients String minLength: 0 socialPort
social backend port advertised to clients Int min: 1, max: 65536 socialBindPort
social backend port the backend binds to (if 0, defaults to socialPort) Int min: 0, max: 65536
pragma.telemetry.db.TelemetryDaoConfig #
DbTelemetryDao configuration.
- Configuration Values:
field description type values/constraints databaseConfig
Database configuration for the game dao. Object of type UnpartitionedDatabaseConfig UnpartitionedDatabaseConfig
pragma.matchcapacity.MatchCapacityServiceConfig #
Match Capacity service configuration.
- Configuration Values:
field description type values/constraints matchCapacityConfig
The values controlling match capacity. Object of type MatchCapacityConfig MatchCapacityConfig
pragma.telemetry.TelemetryServiceConfig #
The Telemetry service collects events and forwards them to a configured data store.
- Configuration Values:
field description type values/constraints
pragma.gateway.GamePartnerGatewayConfig #
Game Partner gateway configuration.
- Configuration Values:
field description type values/constraints protocol
protocol of the host/port String minLength: 0 webSocketProtocol
protocol of the WebSocket host/port String minLength: 0 authenticateHost
authentication backend host String minLength: 0 authenticatePort
authentication backend port Int min: 1, max: 65536 socialHost
social backend host advertised to clients String minLength: 0 socialPort
social backend port advertised to clients Int min: 1, max: 65536 socialBindPort
social backend port the backend binds to (if 0, defaults to socialPort) Int min: 0, max: 65536 gameHost
game backend host advertised to clients String minLength: 0 gamePort
game backend port advertised to clients Int min: 1, max: 65536 gameBindPort
game backend port the backend binds to (if 0, defaults to gamePort) Int min: 0, max: 65536 sdkCoreEnabled
temporary feature toggle for Core SDK until it is stable Boolean options: true
,false
pragma.matchmaking.MatchmakingConfig #
Matchmaking service configuration.
- Configuration Values:
field description type values/constraints matchmakingDelayMillis
Delay, in milliseconds, between matchmaking runs. Long min: -9223372036854775808, max: 9223372036854775807 enableGetMatchmakingInfo
Enables the player-facing endpoint to retrieve operational info about the matchmaking service. Boolean options: true
,false
pragma.account.config.UnsafeIdentityDaoConfig #
UnsafeIdentityDaoNode service configuration.
- Configuration Values:
field description type values/constraints databaseConfig
database config for the unsafe identity provider Object of type UnpartitionedDatabaseConfig UnpartitionedDatabaseConfig canAuthenticate
can be used to authenticate players Boolean options: true
,false
canFederate
can be used to federate players Boolean options: true
,false
pragma.SocialBackendPartnerClientConfig #
Partner client configuration used to communicate with a Pragma Social backend from a Game backend.
- Configuration Values:
field description type values/constraints bearerToken
The bearer token to use when making partner calls to the social backend EncryptedString minLength: 0
pragma.payment.PaymentServiceConfig #
Configuration for the PaymentService
- Configuration Values:
field description type values/constraints
pragma.gateway.BackendGatewayConfig #
Backend gateway configuration.
- Configuration Values:
field description type values/constraints port
port utilized for service-to-service communication Int min: -2147483648, max: 2147483647
pragma.databases.SharedDatabaseConfigServiceConfig #
Configuration lookup for all database connections
- Configuration Values:
field description type values/constraints databaseConfigsByIdentifier
map of database connections Map of Object of type SharedDatabaseConfig SharedDatabaseConfig
pragma.gateway.GamePlayerGatewayConfig #
Game Player gateway configuration.
- Configuration Values:
field description type values/constraints protocol
protocol of the host/port String minLength: 0 webSocketProtocol
protocol of the WebSocket host/port String minLength: 0 authenticateHost
authentication backend host String minLength: 0 authenticatePort
authentication backend port Int min: 1, max: 65536 socialHost
social backend host advertised to clients String minLength: 0 socialPort
social backend port advertised to clients Int min: 1, max: 65536 socialBindPort
social backend port the backend binds to (if 0, defaults to socialPort) Int min: 0, max: 65536 gameHost
game backend host advertised to clients String minLength: 0 gamePort
game backend port advertised to clients Int min: 1, max: 65536 gameBindPort
game backend port the backend binds to (if 0, defaults to gamePort) Int min: 0, max: 65536 sdkCoreEnabled
temporary feature toggle for Core SDK until it is stable Boolean options: true
,false
pragma.party.PartyConfig #
Party service configuration.
- Configuration Values:
field description type values/constraints maxPlayersPerParty
maximum players allowed in each party Int min: -2147483648, max: 2147483647 disableMaxPlayerCount
whether to disable maximum player count limits in each party Boolean options: true
,false
enableLocalGameServerVersions
whether to allow local game clients to override their game server version for local development purposes Boolean options: true
,false
repeatInviteDelaySeconds
defines the delay between a player inviting another player consecutive times Int min: -2147483648, max: 2147483647 inventoryTagsToInclude
tags used to filter player inventories, and items that match one or more tags will be included Map of String minLength: 0 enableTransferPartyLeader
whether to transfer party leader status from one to another when invoking AssignPartyLeaderV1 Boolean options: true
,false
pragma.gateway.SocialPartnerGatewayConfig #
Social Partner gateway configuration.
- Configuration Values:
field description type values/constraints protocol
protocol of the host/port String minLength: 0 webSocketProtocol
protocol of the WebSocket host/port String minLength: 0 authenticateHost
authentication backend host String minLength: 0 authenticatePort
authentication backend port Int min: 1, max: 65536 socialHost
social backend host advertised to clients String minLength: 0 socialPort
social backend port advertised to clients Int min: 1, max: 65536 socialBindPort
social backend port the backend binds to (if 0, defaults to socialPort) Int min: 0, max: 65536
pragma.databases.DatabaseIdentifierSchema #
Database identifier to schema
- Configuration Values:
field description type values/constraints identifier
the database connection settings defined in your databaseConfig per unique identifier String minLength: 0 schema
the database schema to use for connection settings String minLength: 0
pragma.databases.UnpartitionedDatabaseConfig #
Standard Pragma Engine database connection configuration.
- Configuration Values:
field description type values/constraints driver
which driver to use, default: MYSQLDB Enum DatabaseDriver allowed values: MYSQLDB
username
username to use String minLength: 1 password
password to use EncryptedString minLength: 0 hikariConnectionTimeoutMillis
connection timeout in millis for Hikari connection pool, default: 20,000ms Long min: -9223372036854775808, max: 9223372036854775807 hikariMinimumIdleConnections
minimum number of connections to hold open for Hikari connection pool, default: 0 Int min: -2147483648, max: 2147483647 hikariConfigMaximumPoolSize
maximum connection pool size for Hikari connection pool, default: 10 Int min: -2147483648, max: 2147483647 hikariConfigIdleTimeoutMillis
idle timeout in millis for Hikari connection pool, default: 300,000ms Long min: -9223372036854775808, max: 9223372036854775807 dynamicShardingSupport
enables virtual nodes and sharding support, default:false Boolean options: true
,false
hostPortSchema
schema String minLength: 0 identifierSchema
database connection settings for each identifier Object of type DatabaseIdentifierSchema DatabaseIdentifierSchema
pragma.inventory.ContentAccessByTagsConfig #
Content filtering configuration on player endpoints by tags.
- Configuration Values:
field description type values/constraints hidden
Content filtering configuration on player endpoints by tags. Map of String minLength: 0
pragma.inventory.InventoryCacheConfig #
Config for inventory data cache.
- Configuration Values:
field description type values/constraints maxTimeBetweenAccessMillis
If an entry has not been accessed in this amount of time, it is a candidate for removal in the next eviction sweep. Long min: -9223372036854775808, max: 9223372036854775807 sizeBeforeExpirationEnforced
Size of cache before eviction sweeping will start removing entries. Int min: -2147483648, max: 2147483647 sweepIntervalMillis
Interval, in milliseconds, between sweep calls for the cache. Long min: -9223372036854775808, max: 9223372036854775807
pragma.databases.PartitionedDatabaseConfig #
Standard Pragma Engine database connection configuration.
- Configuration Values:
field description type values/constraints driver
which driver to use, default: MYSQLDB Enum DatabaseDriver allowed values: MYSQLDB
username
username to use String minLength: 1 password
password to use EncryptedString minLength: 0 hikariConnectionTimeoutMillis
connection timeout in millis for Hikari connection pool, default: 20,000ms Long min: -9223372036854775808, max: 9223372036854775807 hikariMinimumIdleConnections
minimum number of connections to hold open for Hikari connection pool, default: 0 Int min: -2147483648, max: 2147483647 hikariConfigMaximumPoolSize
maximum connection pool size for Hikari connection pool, default: 10 Int min: -2147483648, max: 2147483647 hikariConfigIdleTimeoutMillis
idle timeout in millis for Hikari connection pool, default: 300,000ms Long min: -9223372036854775808, max: 9223372036854775807 dynamicShardingSupport
enables virtual nodes and sharding support, default:false Boolean options: true
,false
columnNameOfPropertyToConsistentHash
property to shard by (ie playerId) String minLength: 0 hostPortSchemas
host and schemas by index Map of String minLength: 0 identifierSchemas
database connection settings for each identifier Map of Object of type DatabaseIdentifierSchema DatabaseIdentifierSchema
pragma.matchcapacity.MatchCapacityConfig #
Configuration for Match Capacity.
- Configuration Values:
field description type values/constraints floor
Minimum number of matches targeted to be started by the capacity service. Int min: -2147483648, max: 2147483647 ceiling
Maximum number of match capacity managed by the capacity service. Int min: -2147483648, max: 2147483647 headroomPercent
Desired available capacity defined by % of existing matches. Int min: -2147483648, max: 2147483647 serverMaxStartDurationMillis
Maximum duration, in milliseconds, a game server can take to start before the allocation is declared failed. Long min: -9223372036854775808, max: 9223372036854775807 serverHeartbeatPeriodMillis
Expected heartbeat period a game server should report its state. Long min: -9223372036854775808, max: 9223372036854775807 serverHeartbeatExpiryFactor
Number, as a float, of heartbeats before a game server is considered timed out. Double min: 4.9E-324, max: 1.7976931348623157E308 gameCapacityResolvedTimeoutMillis
Maximum duration, in milliseconds, the platform will wait for capacity to resolve for a game instance before ejecting it. Long min: -9223372036854775808, max: 9223372036854775807
pragma.databases.SharedDatabaseConfig #
Database identifier config
- Configuration Values:
field description type values/constraints username
username to use String minLength: 1 password
password to use EncryptedString minLength: 0 host
host String minLength: 0 port
port Int min: -2147483648, max: 2147483647
Plugin Configurations #
demo.account.FakeAuthIdentityProviderPlugin$Config #
Fake Auth Identity Provider plugin configuration.
- Configuration Values:
field description type values/constraints identityProvider
The string name of the id provider this is faking String minLength: 0
pragma.inventory.SteamEntitlementConfig #
Steam entitlement provider plugin configuration.
- Configuration Values:
field description type values/constraints appConfig
Steam app configuration for entitlement processing. Object of type SteamAppConfig SteamAppConfig
pragma.gateway.FilePortalModulePlugin$Config #
File Portal Router plugin configuration.
- Configuration Values:
field description type values/constraints portalSource
path to portal resource files String minLength: 0 modules
modules enabled for the portal Map of String minLength: 0 defaultModule
first module loaded when the portal is opened String minLength: 0 redirectSignInToSocial
can be used to disable the social sign-in redirect Boolean options: true
,false
pragma.config.EmptyPluginConfig #
Empty plugin config for configless plugins.
- Configuration Values:
field description type values/constraints
pragma.account.config.GoogleIdProviderConfig #
Google Identity Provider plugin configuration.
- Configuration Values:
field description type values/constraints portalLoginEnabled
If this id provider is shown in the portal login options. Boolean options: true
,false
allowedDomains
A map of domains that are allowed to use Google to authenticate (e.g. pragma.gg) Map of String minLength: 0 clientSecret
your app’s secret key (provided by Google) EncryptedString minLength: 0 clientId
your app’s id (provided by Google) String minLength: 0 redirectUri
your app’s redirect URI, as defined with Google String minLength: 0
pragma.account.config.TwitchIdProviderConfig #
Twitch Id Provider configuration.
- Configuration Values:
field description type values/constraints portalLoginEnabled
If this id provider is shown in the portal login options. Boolean options: true
,false
clientSecret
your app’s secret key (provided by Twitch) EncryptedString minLength: 0 clientId
your app’s id (provided by Twitch) String minLength: 0 redirectUri
your app’s redirect URI, as defined with Twitch String minLength: 0
pragma.payment.steam.SteamPaymentConfig #
Steam payment plugin configuration.
- Configuration Values:
field description type values/constraints appConfig
Steam app config for payment processing Object of type SteamAppConfig SteamAppConfig defaultCurrencyCode
the default currency code to use when a player’s configured currency is not configured for a product entry. Enum CurrencyCode allowed values: UNUSED_CURRENCY
,USD
,EUR
,CAD
,AED
,ARS
,AUD
,BRL
,CHF
,CLP
,CNY
,COP
,CRC
,GBP
,HKD
,ILS
,IDR
,INR
,JPY
,KRW
,KWD
,KZT
,MXN
,MYR
,NOK
,NZD
,PEN
,PHP
,PLN
,QAR
,RUB
,SAR
,SGD
,THB
,TRY
,TWD
,UAH
,UYU
,VND
,ZAR
,UNRECOGNIZED
demo.matchcapacity.SkeletonCapacityProvider$Config #
Generic skeleton match capacity provider configuration.
- Configuration Values:
field description type values/constraints loadTestClient
type of client to use for making game launch requests, localhost loadtest only or remote capable [true false] Boolean capacityPerServer
amount of matches a server can run concurrently Int min: -2147483648, max: 2147483647 matchLauncher
type of match launcher [demo.matchcapacity.LocalMatchLauncher demo.matchcapacity.GameFlowMatchLauncher String partnerConnectionInfo
Pragma Engine partner connection info for games to report their existence Object of type PartnerConnectionInfoConfig PartnerConnectionInfoConfig clientInitialHeartbeatPeriodMillis
heartbeat period used when the server has not yet responded Long min: -9223372036854775808, max: 9223372036854775807
pragma.party.DefaultGameServerCompatibilityPlugin$Config #
Pragma Engine Nomad match capacity provider configuration.
- Configuration Values:
field description type values/constraints gameServerVersion
hardcoded game server version to return, default value: GameServerVersion1 String minLength: 0
pragma.account.config.EmailIdProviderConfig #
Email Id Provider configuration.
- Configuration Values:
field description type values/constraints privateKey
an encrypted private key used for encrypting emails in Pragma Engine’s database EncryptedString minLength: 0
pragma.account.config.EpicIdProviderConfig #
Epic Id Provider configuration.
- Configuration Values:
field description type values/constraints portalLoginEnabled
If this id provider is shown in the portal login options. Boolean options: true
,false
pragma.account.SendInBlueEmailSenderPlugin$SendInBlueEmailSenderConfig #
EmailSender plugin configuration.
- Configuration Values:
field description type values/constraints providerAPIKey
the API key that will enable you to send emails with your provider EncryptedString minLength: 0 apiUrl
base URL for the provider API to interact with String minLength: 0 route
the HTTP route for the provider String minLength: 0 verificationTemplateId
id of the email template to send String minLength: 0 fromEmail
verified email address associated with the account in sendinblue that this email will be sent from String minLength: 0 fromName
name displayed String minLength: 0
pragma.gateway.PostmanRoutePlugin$Config #
Postman Route Plugin configuration.
- Configuration Values:
field description type values/constraints pathToPostmanFiles
path to postman files String minLength: 0 collectionName
path to postman files String minLength: 0 environmentName
path to postman files String minLength: 0
pragma.metrics.StatsdRegistryProvider$Config #
Statsd metrics registry provider configuration.
- Configuration Values:
field description type values/constraints flavor
flavor of statsd Enum StatsdFlavor allowed values: ETSY
,DATADOG
,TELEGRAF
,SYSDIG
host
host to send stats String minLength: 0 port
port to send stats Int min: -2147483648, max: 2147483647 protocol
protocol to send stats Enum StatsdProtocol allowed values: UDP
,UDS_DATAGRAM
,TCP
maxPacketLength
max packet length to send stats Int min: -2147483648, max: 2147483647 pollingFrequencySeconds
polling frequency to send stats Int min: -2147483648, max: 2147483647 stepSeconds
step size to compute windowed statistics Int min: -2147483648, max: 2147483647 publishUnchangedMeters
whether to publish unchanged meters Boolean options: true
,false
buffered
whether to buffer metrics sent Boolean options: true
,false
pragma.matchcapacity.MultiplayCapacityProvider$Config #
MultiplayClientNode service configuration.
- Configuration Values:
field description type values/constraints capacityPerServer
amount of matches a server can run concurrently Int min: -2147483648, max: 2147483647 regionId
regionId for Multiplay API calls String minLength: 0 fleetId
fleetId for Multiplay API calls String minLength: 0 profileId
profileId for Multiplay API calls String minLength: 0 projectGuid
project guid for Multiplay API calls String minLength: 0 accessKey
Clanforge Access Key for signing REST API calls to Multiplay String minLength: 0 secretAccessKey
Clanforge Secret Access Key for signing REST API calls to Multiplay EncryptedString minLength: 0 useAllocateV2
feature toggle to enable using Multiplay AllocateV2 Boolean options: true
,false
pragmaGamePartnerBackendAddress
tells the Multiplay game server where the Pragma Game Partner gateway is, and is only used when AllocateV2 is enabled String minLength: 0 gameServerZoneToMultiplayRegionId
map of gameServerZone to Multiplay region id Map of String minLength: 0
pragma.metrics.DatadogRegistryProvider$Config #
Datadog metrics registry provider configuration
- Configuration Values:
field description type values/constraints apiKey
Datadog API key EncryptedString minLength: 0 applicationKey
Datadog application key EncryptedString minLength: 0 descriptions
whether to send descriptions metadata Boolean options: true
,false
hostTag
host tag when shipping metrics String minLength: 0 uri
URI to ship metrics to String minLength: 0
pragma.matchcapacity.PragmaNomadCapacityProvider$Config #
Pragma Engine Nomad match capacity provider configuration.
- Configuration Values:
field description type values/constraints url
full URL (including protocol and port) to reach the Nomad API URL capacityPerServer
amount of matches a server can run concurrently Int min: -2147483648, max: 2147483647 executableName
name of the executable such as ‘gameServer.sh’ String minLength: 0 args
command line args to pass to the start game server script, and chains together map values, ordered by key Map of String minLength: 0 jobCpu
Amount of cpu to allocate per task instance in MHz. See https://developer.hashicorp.com/nomad/docs/job-specification/resources#cpu Int min: -2147483648, max: 2147483647 jobDatacenter
Nomad Datacenter to allocate new task instance. See https://developer.hashicorp.com/nomad/api-docs/json-jobs#datacenters String minLength: 0 jobMemory
Amount of memory to allocate per task instance in MB. See https://developer.hashicorp.com/nomad/docs/job-specification/resources#memory Int min: -2147483648, max: 2147483647
pragma.account.config.DiscordIdProviderConfig #
Discord Id Provider configuration.
- Configuration Values:
field description type values/constraints portalLoginEnabled
If this id provider is shown in the portal login options. Boolean options: true
,false
clientSecret
your app’s secret key (provided by Discord) EncryptedString minLength: 0 clientId
your app’s id (provided by Discord) String minLength: 0 guildId
your guild id, also known as server id String minLength: 0 redirectUri
your app’s redirect URI, as defined with Discord String minLength: 0 botToken
bot token associated with your Discord Server’s bot EncryptedString minLength: 0 allowedRoleIds
set of guild role ids that provide access to Pragma Engine social backend Map of String minLength: 0
pragma.matchcapacity.LocalProcessCapacityProvider$Config #
Generic Local Process match capacity provider configuration.
- Configuration Values:
field description type values/constraints processCommand
full command line including parameters run the process Map of String minLength: 0 serverIdParam
name of the command line param to append with the allocated server id String minLength: 0 logPathParam
name of the command line param to append with the program log path, and this will result in a file inside logOutputPath String minLength: 0 logOutputPath
path to a folder where to redirect log output String minLength: 0 maximumLocalServers
maximum number of local servers this provider can support Int min: -2147483648, max: 2147483647 portParam
name of the command line param to append with the allocated host port value String minLength: 0 gameServerZoneParam
name of the command line param to append with the game server zone String minLength: 0 minPort
minimum value of the game server host port Int min: -2147483648, max: 2147483647 maxPort
maximum value of the game server host port Int min: -2147483648, max: 2147483647
pragma.shared.SteamAppConfig #
Steam application configuration.
- Configuration Values:
field description type values/constraints portalLoginEnabled
If this id provider is shown in the portal login options. Boolean options: true
,false
steamWebAPIKey
your app’s secret web API key (provided by Steam) EncryptedString minLength: 0 appId
your app’s id (provided by Steam) String minLength: 0 restrictByAppOwnership
Prevent authentication if the player does not own the app specified by appId Boolean options: true
,false
restrictByAccountBan
Prevent authentication if the player is banned Boolean options: true
,false
demo.gameinstance.GameFlowGameInstancePlugin$Config #
GameFlowGameInstancePlugin plugin configuration.
- Configuration Values:
field description type values/constraints matchDurationMillis
the duration of game in milliseconds Long min: -9223372036854775808, max: 9223372036854775807
demo.pragmaconfidential.xbox.XboxIdentityProviderPlugin$Config #
XBox Id Provider configuration.
- Configuration Values:
field description type values/constraints portalLoginEnabled
If this id provider is shown in the portal login options. Boolean options: true
,false
relyingPartyCertificate
The base64 encoded RelyingParty certificate. String minLength: 0 relyingPartyPrivateKey
The base64 encoded RelyingParty private key. EncryptedString minLength: 0 privateKeyPassword
The password to decrypt the private key. EncryptedString minLength: 0
pragma.party.OrderedGameServerCompatibilityPlugin$Config #
OrderedGameServerCompatibility plugin configuration.
- Configuration Values:
field description type values/constraints versionCompatibility
map of all the server versions to compatible game client versions Map of Object of type VersionCompatibility VersionCompatibility
pragma.inventory.EpicEntitlementConfig #
Epic entitlement provider plugin configuration.
- Configuration Values:
field description type values/constraints sandboxId
ID of the sandbox to operate on. String minLength: 0 deploymentId
ID of the corresponding deployment in the Epic Dev Portal. String minLength: 0 clientId
ID of your client in the Epic Dev Portal. String minLength: 0 clientSecret
Encrypted string representing your client’s secret in the Epic Dev Portal. EncryptedString minLength: 0
demo.pragmaconfidential.playstation.PlaystationApiConfig #
Playstation Id Provider configuration.
- Configuration Values:
field description type values/constraints portalLoginEnabled
If this id provider is shown in the portal login options. Boolean options: true
,false
redirectUri
your app’s redirect URI, as defined with Playstation String minLength: 0 ps4ClientId
your app’s id (provided by Playstation) String minLength: 0 ps4ClientSecret
your app’s client secret (provided by Playstation) EncryptedString minLength: 0 ps5ClientId
your app’s id (provided by Playstation) String minLength: 0 ps5ClientSecret
your app’s client secret (provided by Playstation) EncryptedString minLength: 0 environment
The playstation environment set in the request urls String minLength: 0 ps5EnvironmentHost
The playstation host url per environment String minLength: 0
pragma.inventory.TwitchEntitlementConfig #
Twitch Drop entitlement provider plugin configuration.
- Configuration Values:
field description type values/constraints clientId
ID of your client in the Twitch Dev Portal String minLength: 0 clientSecret
Secret of your client in the Twitch Dev Portal EncryptedString minLength: 0 gameId
The game ID associated with the drops to sync String minLength: 0
pragma.matchmaking.WarmBodyMatchmakingPlugin$Config #
WarmBodyMatchmakingPlugin configuration.
- Configuration Values:
field description type values/constraints numberOfTeams
number of teams required for the match Int min: 1, max: 2147483647 playersPerTeam
number of players required for each team Int min: 1, max: 2147483647
pragma.shared.SteamAppConfig #
Steam application configuration.
- Configuration Values:
field description type values/constraints portalLoginEnabled
If this id provider is shown in the portal login options. Boolean options: true
,false
steamWebAPIKey
your app’s secret web API key (provided by Steam) EncryptedString minLength: 0 appId
your app’s id (provided by Steam) String minLength: 0 restrictByAppOwnership
Prevent authentication if the player does not own the app specified by appId Boolean options: true
,false
restrictByAccountBan
Prevent authentication if the player is banned Boolean options: true
,false
pragma.matchcapacity.PartnerConnectionInfoConfig #
Connection configuration for Pragma Partner endpoints.
- Configuration Values:
field description type values/constraints protocol
Pragma Engine partner protocol (http/https) String minLength: 0 host
Pragma Engine partner host name String minLength: 0 port
Pragma Engine partner port Int min: -2147483648, max: 2147483647
pragma.party.VersionCompatibility #
clientVersions to serverVersion support configuration.
- Configuration Values:
field description type values/constraints serverVersion
game server version string, must not be empty String minLength: 0 clientVersions
game client versions supported by this server version Map of String minLength: 0