Highlights

• A host of new LiveOps Dashboard features, documentation, and general usability improvements. Most notably:
  • Player name changing (implementation guide in Changing the Players Name )
  • GDPR data export (implementation guide in GDPR Compliance )
  • Reconnecting player accounts
  • Player search
  • New, more detailed purchase history & failure logs
• In-app purchase validation fixes
  • Robustness improvements in the event of disconnects or transient validation errors
  • Support for clearing pending duplicate purchases from the PlayerModel

Breaking Changes & Migration

• A new OnPlayerBannedStatusChanged(bool isBanned) event has been added to more conveniently detect a player getting banned while logged in to the game. Example code at ‣.
  • No action required. Migrating existing code to use this event is optional.
• The new player search feature relies on a new database field that is populated as player actors are activated. That means that the search won't find any existing players that have never logged in after the update.
  • No action required for typical use. If searching for old inactive players is important to your use case, you could cycle all player actors once. Just drop us a message and let's discuss!
• Forcing .NET Core runtime image to version 3.1.3 to avoid issues (in versions 3.1.4 and 3.1.5) with certificate roots which breaks GameCenter authentication.
  • No action required. All affected environments have been migrated by us.
• Player name changes are now validated on the server. This has necessitated a change in the way that client code changes a player's name.
  • If you previously allowed the player to change their own name then you would have done so by triggering a PlayerChangeName action. Now you should send a PlayerChangeOwnNameRequest message instead.
• Support for a new PlayerClearPendingDuplicateInAppPurchase action has been added. When a pending purchase has the ReceiptAlreadyUsed status, the client should invoke this action and also confirm the purchase to the IAP store. This is analogous to how purchases with the ValidReceipt status are claimed with PlayerClaimPendingInAppPurchase.
  • Before using clients that invoke this new action, an updated server should be deployed in order to support it.

Change Log

Added

• Use GCP service account -based authentication when publishing GameConfigs to server
• Reference project: Added OnPlayerBannedStatusChanged() to StateManager
• Reference project: Added in-app purchase shop (with a fake IAP store for now) and validation flow
• SDK: Added ExcludeFromGdprExport attribute to PlayerModel
• Dashboard: Added player search
• Dashboard: Added a generic UI component to warn about disruptive actions
• Dashboard: Added a new GDPR data export feature to player details
• Dashboard: Added a new account reconnect feature to player details
• Dashboard: Added name changing to player details
• Dashboard: Added failed and pending puchases to player details
• Dashboard: Added social authentications to player details
• SDK: Serializer now supports sbyte, short and ushort
• SDK: Interfaces can now be serialized in certain simple cases

Changed

• Dashboard: Better IAP purchase history card that scales to large amounts of transactions and shows the purchase IDs
• Dashboard: Various ID fields changed to a monospace font for better legibility
• Dashboard: Player banning UI now looks and feels more like everything else
• Dashboard: Added route ID's to headerbar for a more obvious differentiation between many tabs
• Dashboard: Layout tweaks to player details to make the content flow better at various aspect rations
• Reference project: OnPlayerExecuteServerAction() moved from StateManager to MetaplayClient for less user land boilerplate
• Forcing .NET Core runtime image to version 3.1.3 to avoid issues (in versions 3.1.4 and 3.1.5) with certificate roots which breaks GameCenter authentication
• BotClient: Introduce Config.local.json (used by default) and only leave Prometheus metrics disabled when running locally
• SDK: Serializer: when deserializing to a shorter-than-int integer type, if the magnitude of the value is too large, throw instead of silently truncating
• SDK: Basic support for querying database read-replicas
• SDK, dashboard: Added optional down-time estimate for maintenance mode
• SDK: Serializer: when deserializing to a shorter-than-int integer type, if the magnitude of the value is too large, throw instead of silently truncating

Fixed

• Generated serializer now works in Unity builds using Mono (previously only worked with IL2CPP builds)
• SDK: Fixes to in-app purchase persistence, validation retries, and treatment of transient validation error as success for the player's benefit
• SDK: Fixed in-process collected memory metrics (exposed via Prometheus to Grafana)
• Dashboard: Fixed very specific window sizes causing ugly line breaks in admin action buttons
• Dashboard: Fixed player reset action
• Reference project: Fixed broken aspect ratios in debug menu layout
• OfflineServer: Don't react to a IPlayerModelServerListener event until the corresponding action is acked

Refactors

• SDK: Removed the old reflection-based TaggedWireSerializer (class is still there for the utility functions used elsewhere)