Pragma Engine 0.0.66

May 3rd, 2022

Features #

  • The Unity SDK now logs debug details from service errors.
    • Description: Developers can now view service errors in the Unity Editor console.
  • Match reconnect now available.
    • Description: Match reconnect is now available using the Party system and can be used by players to rejoin in-progress matches.

Deprecations #

  • /v1/info endpoint connection fields are being renamed.

    • Description: The scheme and wsScheme fields in the <protocol>://<host>:<port>/v1/info endpoint are being deprecated, and will be replaced with protocol and webSocketProtocol.
      OriginalReplacementRemoval Patch
      schemeprotocol0.0.68
      wsSchemewebSocketProtocol0.0.68
  • Inventory MatchEndV0 RPC and protos are being renamed to MatchEndV1.

    • Description: Changes are only required to custom services making calls to this endpoint. No changes are required to services making calls to MatchLifecycleService.matchEndV3.
    • InventoryRpc protos:
      OriginalReplacementRemoval Patch
      MatchEndV0RequestMatchEndV1Request0.0.68
      MatchEndV0ResponseMatchEndV1Response0.0.68
    • Inventory RPC service route:
      OriginalReplacementRemoval Patch
      matchEndV0matchEndV10.0.68

Integrations #

  • Change from MariaDB to MySQL.
    • Description: Beginning in release 0.0.66, Pragma Engine will no longer have an in-memory option for databases. Your platform and infrastructure will not load until you have completed this change. All data that is not migrated to MySQL will be lost.
    • Integration step: A guide has been provided for affected customers. Follow the guide for instructions for both local and non-local environments.
  • Update partnerConnectionInfo config in configuration YAML files.
    • Description: The url config property is being deprecated. Provide the appropriate values for the host, port, and protocol fields instead. Note that protocol defaults to http in development mode, but a protocol must be specified in production mode in order for the platform to successfully start up.
    • Integration step: Update partnerConnectionInfo config as specified below.
OriginalReplacement
partnerConnectionInfo:
  url: "http://localhost"
  host: "localhost"
  port: 10106
partnerConnectionInfo:
  protocol: "http"
  host: "localhost"
  port: 10106
  • Update InstancedItemPlugin code that uses UpdateResult.
    • Description: instancedItemGrants has been renamed to instancedItemServerGrants.
    • Integration steps: Update all plugins that return a InstancedItemPlugin.UpdateResult by renaming instancedItemGrants to instancedItemServerGrants.
OriginalReplacement
return InstancedItemPlugin.UpdateResult(
  extInstancedItem
  instancedItemGrants
  stackableItemGrants
)
return InstancedItemPlugin.UpdateResult(
  extInstancedItem
  instancedItemServerGrants
  stackableItemGrants
)
  • Change ContentDataNodeService.getHandler method.
    • Description: The ContentDataNodeService.getHandler method with kclass parameter has been removed, and you’ll need to confirm you’re using the recommended, functional method.
    • Integration step: Use the ContentDataNodeService.getHandler method without the kclass parameter.
OriginalReplacement
fun <ContentProto : GeneratedMessageV3> getHandler(
  kClass: KClass<ContentProto>,
  resourcePath: String
): ContentData<ContentProto>
fun <ContentProto : GeneratedMessageV3> getHandler(
  resourcePath: String
): ContentData<ContentProto>
  • Update the following functions as mentioned in release 0.0.64.

    • Description: Session and WebSocket cleanup changes.
    • Integration step: Make the following changes:
      OriginalReplacement
      JumpData::longClassNameToShortName()ProtoUtils.protoShortName()
      TokenUtils.createPragmaJWTuse PragmaJwtSigner methods
  • Update server configuration for listed gateway config fields.

    • Description: Update server configuration for the following gateway config fields.
    • Integration step: SocialOperatorGatewayConfig, SocialPlayerGatewayConfig, SocialPartnerGatewayConfig, GameOperatorGatewayConfig, GamePlayerGatewayConfig, GamePartnerGatewayConfig
      OriginalReplacement
      schemaprotocol
      wsSchemawebSocketProtocol

Bugs and Fixes #

  • Pragma Portal now properly excludes players who are already a member of a group from being shown in the Add Accounts to Player Group page for that group.

Docs #