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.

    Original	Replacement	Removal Patch
    scheme	protocol	0.0.68
    wsScheme	webSocketProtocol	0.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:

    Original	Replacement	Removal Patch
    MatchEndV0Request	MatchEndV1Request	0.0.68
    MatchEndV0Response	MatchEndV1Response	0.0.68

  • Inventory RPC service route:

    Original	Replacement	Removal Patch
    matchEndV0	matchEndV1	0.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.

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.

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.

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:

    Original	Replacement
    JumpData::longClassNameToShortName()	ProtoUtils.protoShortName()
    TokenUtils.createPragmaJWT	use 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

    Original	Replacement
    schema	protocol
    wsSchema	webSocketProtocol

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 #

• [New Services Guide] Match reconnect added.
• [Updated Services Guide] Details added to Play Again section.