Highlights

INFO

This is a light maintenance release before the holiday season. Enjoy the sun!

• Various LiveOps Dashboard usability improvements. For example:

  • Player search by ID is now case-insensitive.

  • Inbox mail deletions now have a confirmation pop-over.

    ![](images/r13-inbox-mail-deletions.png)
    

  • Better handling of the new, very long Google Play IAP transaction receipts.

    ![Cleaner layout keeps the IAP history legible at-a-glance!](images/r13-google-iap-receipts.png)
    

  • Shop Offers now have a "Seen By" count which tells how many players the offer has been shown to.

    ![3 players have seen this example offer so far.](images/r13-offer-seen-by.png)
    

  • Player list now highlights paying players with an icon to identify them faster.

    ![Hover over the icon for a tooltip!](images/r13-list-tooltip.png)
    

  • There is now a tooltip about when the player segments have last been sampled.

    ![](images/r13-player-segment-tooltip.png)
    

  • Player's auth methods now show when they have been added into the account, and individual auth methods can be deleted.

    ![This account can be accessed from an iMac, added 6 days ago.](images/r13-auth-methods.png)
    

  • Broadcasts now have their own audit logs.

    ![This broadcast was created 18 days ago by an anonymous admin.](images/r13-broadcast-audit-logs.png)
    

• Added support for GameConfigLibrary aliases for handling renamed config item references, see Working with Game Config Data

Breaking Changes

• To facilitate collection of statistics about activables (such as the "Seen By" counts of shop offers), the [MetaActivableGameConfigLibrary] and [MetaActivablePlayerSubModel] attributes have been replaced by [MetaActivableConfigData] and [MetaActivableSet] attributes, which should now be put on the config and state classes rather than on members of MainGameConfig and PlayerModel. Additionally, subclasses of MetaActivableState need to implement a getter that returns the id of the activable.
  • No action needed; we have updated your existing code accordingly.

Under-the-Hood Highlights

• LiveOps Dashboard now has a high visibility notification for browser errors and warnings. This can greatly help spotting otherwise silent problems while testing new features.

• LiveOps Dashboard now has a game specific styles folder with preloaded .sass files for easy manipulation of global styles and variables.
• LiveOps Dashboard dependencies have been updated. Most notably it no longer depends on the node-sass package that had known problems to build on certain machines.
  • Action needed: run npm install to refresh the dependencies before running the dashboard locally!
• Various improvements related to certain types of connectivity problems where login is successful, but no further client-sent messages reach the server.
  • Improved server-side diagnostics to further help investigate the issue in the future.
  • Improved client-side connection health indication, so that it avoids indicating healthiness prematurely.
  • Improved port randomization logic to trigger even with recoverable connection drops in attempt to evade further port-specific network errors.
  • Improved flushing logic when app is put into the background to block app suspend (up to 100ms) until underlying socket operations complete.
• PlayerActorBase has new integration entrypoints ShouldUpdatePlayerSearch() and GetPlayerSearchStrings() for supplying your own player search strings (used for the dashboard player search, for example).
• The way to visualize purchase content in the dashboard player purchase history has been updated to use the integration.js integration mechanism instead of custom game-specific components (custom visualization components are still supported though!).
• The global.json which specifies the .NET Core version to use with the dotnet CLI tool is now located in the Server/ directory, so it applies to all server-side projects.
• Dashboard broadcast components (list, form, detail) now accept a broadcastType component for creating custom features built on top of the broadcast functionality.

Version Compatibility

Infrastructure and Helm chart compatibilities for this release:

• Minimum version requirements
  • Requires infra-modules version 0.1.3 or later for infrastructure
  • Requires metaplay-gameserver Helm chart version 0.2.0 or later for deployment
• Suggested versions
  • Recommended infra-modules version 0.1.4 or later for infrastructure
  • Recommended metaplay-gameserver Helm chart version 0.2.2 or later for deployment

Change Log

Added

• SDK: New PlayerActorBase methods ShouldUpdatePlayerSearch() and GetPlayerSearchString() that can be overridden to provide custom player search strings.
• SDK: Added MetaDatabase.InsertOrUpdateAsync() for inserting a new or updating an existing record in a database table.
• SDK: Added GameConfigLibrary.RegisterAlias() to allow config ID aliases. This can be used for renaming config entries so that data serialized with old configs still continue to deserialize properly.
• Dashboard: Frontend errors and warnings now spawn notification messages so they are easier to notice without having the browser console open!
• Dashboard: New GameTypeDisplay generic component for rendering user-derived types based on integration.
• Dashboard: Segment size and audience size estimates now show how old the estimates are with a tooltip.
• Dashboard: The detail page of an activable displays how many players have activated it at least once.
• Dashboard: Game specific SASS files for defining your own variables and styles.
• Dashboard: Added icons next to players who have purchased IAP to make paying players easier to identify.
• Dashboard: Notifications detail page now shows audit log entries.
• Dashboard: Devices & Social Auths card on Player Details page now shows the date that each auth method was attached.
• Dashboard: Added ability to remove individual auth methods from a player.

Changed

• SDK: Transient errors in IAP validation are no longer treated as successful. Instead, the server periodically retries such validations. This is transparent to the client, and the Status of the purchase will remain PendingValidation until it has been validated.
• SDK: [MetaOnDeserialized] methods are now called in class hierarchy order, base class first. The attribute is now forbidden on non-final virtual methods.
• SDK: The [MetaActivableGameConfigLibrary] and [MetaActivablePlayerSubModel] attributes have been replaced by [MetaActivableConfigData] and [MetaActivableSet] attributes, which should now be put on the config and state classes rather than on members of MainGameConfig and PlayerModel.
• SDK: Player search now supports searching by player ID in case-insensitive fashion.
• SDK: Removed PlayerModelBase.IsNameSearchValid and added PlayerModelBase.SearchVersion for tracking if the player name search database entries are up to date.
• SDK: Classes deriving from MetaActivableState now need to implement a getter that returns the id of the activable. The id is used by the SDK for collecting statistics about activables.
• SDK: On client, when server connection is lost and session resumption is done, consider the connection healthy once again only after server is known to have received the messages so far.
• SDK: On server, when a game connection ends, log information about remaining incoming data.
• SDK: On client, repeated connection resumptions, even if successful, trigger backup port cycling behavior.
• SDK: On application suspend, MetaplaySDK may block the app for up to 100ms for any pending messages to be delivered to the socket.
• SDK: Moved the Server/Game.Server/global.json file to Server/ to enable it on all .NET Core projects.
• Dashboard: Added a link to the referred offer in the "additional conditions" list of the offer details page
• Dashboard: Added more consistent styling and links to referenced segments in the individual segment conditions card.
• Dashboard: Notification details page's start time text label now has a tooltip.
• Dashboard: Ongoing work to generalise various components into reusable forms with opinionated styling to keep the overall UI layout more consistent.
• Dashboard: DynamicPurchaseContent.vue and ResolvedPurchaseContent.vue removed, replaced by new integration API addPurchaseContentType().
• Dashboard: Added confirmation modal when deleting player mail.
• Dashboard: Player's total IAP spend is now calculated server-side instead in the browser.

Fixed

• SDK: Added stricter checks in Google Play IAP validation to disallow replaying the same receipt with different transaction IDs.
• SDK: MetaActivableSet.TryGetVisibleStatus: Make player's current UTC offset not affect already-existing active and in-review activables. Fix in-review status to report the relevant (previous) schedule occasion, not the next.
• SDK: On client, fix DisconnectedFromServer not being emitted if connection was closed due to application being suspended for too long, or if manually closed.
• Dashboard: Fixed deleted guild background color rendering on wide screens.
• Dashboard: Fixed sort order in meta-list-cards
• Dashboard: Fixed manual login UI flashing on initial load when auth0 is not configured.
• Dashboard: Fixed issue when multiple meta-collapse items shared the same id.
• Dashboard: A meta-collapse component that has nothing in the collapse slot no longer shows the clickable "hand" icon when moused over.
• Dashboard: Fixed overflowing layout when viewing database items of a large database.
• Dashboard: Fixed overflowing layout caused by very long IAP transaction receipts.