AGS 2025.2.0 Release Notes

Last updated on March 10, 2025

Release date: March 12th, 2025

Versions​

AccelByte Gaming Services (AGS) Game SDK

To ensure the highest quality, the Game SDK is scheduled for release on March 17th, 2025.

  • Unreal Engine: TBA
  • OSS: TBA
  • Network-Utilities: TBA
  • Unity: TBA
  • P2P Unity: TBA

Extend SDK (previously known as Server SDK) latest version:

Please refer to the respective GitHub releases page:

AccelByte Multiplayer Servers (AMS) CLI

  • AMS CLI: 0.245.31

Highlights​

  • Introduced a new AccelByte Discord Server in Shared Cloud which integrated with Kapa AI to serve as a new Community Forum and go-to-person to ask anything related to AccelByte services. The invitation should be available in your Admin Portal Homepage or can be accessed via this link.

  • Introducing an Audit Log tab in the Lookup Users page of the Admin Portal & ability to leave comments on each audit log
    Previously, if an admin wanted to find the audit logs of a specific user, they would have to go into the Audit Logs page of the Admin Portal and manually query for the user. With this improvement, an admin could just find the specific user on the Lookup Users page and go into the Audit Log tab, the logs displayed will be automatically filtered to that specific user.
    Some contexts are usually needed to know why a certain audit log happened, having the ability to leave comments on each log would help in letting admins leave important context for a specific log.

    • How to access/use it from the Admin Portal
      • On the Admin Portal sidebar: Lookup Users → Search for the user → Audit Log tab

  • A new section, called ‘Critical Events’, is added to the Overview tab in the Lookup Users page in the Admin Portal
    This section provides logs of actions that are considered to be critical (e.g. reset password, account deletion request, suspicious login attempt, etc.) that were done to the account of the specific user from the Lookup Users page.
    Previously, there was no quick way to know - at a glance - what actions a player has done to their own account.

    • How to access/use it from the Admin Portal
      • On the Admin Portal sidebar: Lookup Users → Search for the user → Overview tab → Critical Events
    • Note: here are the currently supported critical events:
    • Two-Factor Authentications
      • 2FA Method Activation - Authenticator App → To trigger this event you can activate 2FA with the authenticator app.
      • 2FA Method Deactivation - Authenticator App → To trigger this event you can deactivate 2FA with the authenticator app.
      • 2FA Method Activation - Backup Codes → To trigger this event you can activate 2FA with the backup codes.
      • 2FA Method Deactivation - Backup Codes → To trigger this event you can deactivate 2FA with the backup codes.
      • 2FA Method Activation - Email Authentication → To trigger this event you can activate 2FA with the email authentication.
      • 2FA Method Deactivation - Email Authentication → To trigger this event you can deactivate 2FA with the email authentication.
    • GDPR
      • Personal Data Request → To trigger this event you can request personal data.
      • Account Deletion Request → To trigger this event you can request account deletion.
    • Login
      • Suspicious Login → To trigger this event you can login/generate access_token with a different browser or different IP location

  • Enhanced Steam IAP Sync with Refund Support

    Previously, our Steam IAP Sync implementation consumed IAP items from the Steam Inventory when transferring ownership management to AGS Entitlements. This made it difficult for Game Admins to manage and process Steam refunds, as the items were already consumed from the player's Steam Inventory.

    With this new implementation, Game Admins can now select a new Steam IAP Sync mode that relies on Steam’s getReport endpoint to synchronize Steam transactions. This allows for seamless granting and revoking of rewards, making it significantly easier to handle Steam refunds for IAP items.

    • How to access/use it from the Admin Portal
      • On the Admin Portal sidebar, go to Game Setup > 3rd Party Configurations > Store, then open the Steam tab.
      • Create a new Steam configuration or edit an existing one.
      • Under Sync Mode, select Steam Transaction to enable the new sync mode.
      • Choose the appropriate Environment, then click Add or Save to apply the configuration.
      • Note: Once data has been generated using the selected sync mode, switching back or changing the sync mode will no longer be possible.
    • How to access/use it from SDK
      • This functionality will be available in an upcoming AGS Game SDK update (TBA).

  • New Safeguards for Store Item Dependencies and DLC Integrity

    Previously, invalid item mappings could go undetected, leading to syncing issues with platform purchases. If an item was deleted or disabled from the AGS published store while still being referenced elsewhere—such as in Catalogs, Rewards, Code Redemptions, DLC, or IAP—there was no system in place to flag these dependencies.

    With this update, attempting to delete or disable an item that is actively referenced will now return an error, requiring Game Admins to validate dependencies before proceeding. However, if Game Admins are aware of these constraints, they will still have the option to force delete/disable the item and handle the affected configurations later.

    Additionally, we have improved the DLC configuration page in the Admin Portal, making it easier to identify inactive or deleted item references within DLC configurations.

    • How to access/use it from the Admin Portal
      • Detect item dependency on Store Items
        • On the Admin Portal sidebar, go to Commerce > Stores, then open the Draft Store
        • Go to Catalog Configurations to manage default validation settings before deleting or disabling an item.
          • By default, the service will check for dependencies in Entitlements, Catalogs, Rewards, Code Redemptions, DLC, and IAP.
        • When attempting to disable or delete an item, a confirmation prompt will display all referenced features using that item.
        • To confirm the action, type DISABLE or DELETE as prompted.
      • DLC Item reference improvements
        • On the Admin Portal sidebar, go to Commerce > In-App Purchase > DLC Setting.
        • Within the DLC Configuration section, any DLC ID containing a disabled or deleted item will now be marked with a warning icon, making it easier to spot and resolve dependencies.

  • Statistics support Negative value

    Our Statistics service originally only allowed positive values for User Statistics items. This meant that use cases requiring negative values (e.g., Karma stats in games like Fallout) needed to be offset to fit within the system’s constraints.

    With this update, Game Admins can now set a negative Minimum Value in Statistics configurations, allowing User Statistics items to drop below zero.

    • How to access/use it from the Admin Portal
      • On the Admin Portal sidebar, go to Progression & Inventory > Statistics > Configuration
      • Click Add Configuration to create a new Statistics configuration.
      • Fill in all required fields. To support negative values, set the Min. Value to a negative number.
      • Click Add to Save the configuration.
    • How to access/use it from SDK
      • No changes are required when updating Statistics values through the SDK.
      • Negative values will only be applied to Statistics configurations where the Minimum Value is set to a negative number.
      • The clamping behavior remains unchanged, ensuring values stay within the defined min/max limits.
    • How to access it through REST API
      • No changes are required when updating Statistics values through the REST API.
      • Negative values will only be applied to Statistics configurations where the Minimum Value is set to a negative number.
      • The clamping behavior remains unchanged, ensuring values stay within the defined min/max limits.

  • Analytics game standard events

    The Game Standard Events dashboards are a collection of dashboards driven by game standard event telemetry from the Game SDK. These dashboards give title-specific insights on player engagement, progression, and in-game economy. They also aid developers with balancing decisions and evaluating the effects of changes.

    With the Game Standard Events dashboards, game developers can gain deep insights into player engagement, track progression, and analyze the in-game economy. These dashboards help identify bottlenecks, balance gameplay, and fine-tune monetization strategies. Plus, they make it easier to measure the impact of updates and adjust mechanics based on real player data—ensuring a smoother, more engaging experience for everyone

    • How to access/use it from the Admin Portal

      • On the Admin Portal sidebar, go to Analytics > Game standard dashboard

      • Under the Game standard dashboard, there will be sub-sections as follows:

        • Resource dashboard
          The Resource dashboard provides developers with insights into the overall state of the in-game economy. This helps them to make informed balancing decisions and validate the impact of those changes over time.

        • Mission dashboard
          The Missions dashboard tracks how players engage with and complete tasks or quests within the game.

        • Leveled dashboard
          The Level Distribution chart displays the distribution of the most recently achieved level brackets for each entity or player within the specified timeframe. The brackets are sorted left to right based on the number of entities they contain, with the bracket containing the highest number of entities positioned furthest to the left.

          The term "level" can be used interchangeably with other stats sent through the game standard event, such as PVP level, account level, etc.

        • Deaths dashboard
          The Deaths dashboard displays the number of deaths each day that occur to the filtered entity type. The data is also available aggregated by location, type and source.

        • Popups dashboard
          Popups can be tutorial prompts, promotions, errors, and other messages that are displayed to users. Use the Popups dashboard for insights into how often a type of popup appears.

          The dashboard offers a searchable table of popup counts by appearances, grouped by their type and name

        • Match info dashboard
          The Matchinfo dashboard tracks the participation of match-based content, its duration, as well as player win rates.

    • How to access/use it from SDK

      • This functionality will be available in an upcoming AGS Game SDK update (TBA).

  • Use AMS Without Subscribing to AGS

    AccelByte Multiplayer Servers (AMS) was an add-on to AccelByte Gaming Services (AGS). With the 2025.2 release, we’re making AMS to be a standalone product. Developers no longer need to migrate their entire game online backend to AccelByte or subscribe to AGS just to use AMS. This update provides more flexibility, allowing teams to integrate AMS into the existing infrastructure without significant overhead.

    • How to access/use it from the Admin Portal
      • Register for the service.
      • Choose between AccelByte Gaming Service (includes AMS) or AMS Only.
      • Activate your free trial.
      • If you choose AMS Only, you will see a menu for AMS configuration only
    • How to access/use it from SDK
      • N/A

  • Submit New Bare Metal Orders and Terminate Bare Metal Requests via the admin portal for shared cloud customers

    We’ve introduced a new feature that allows users to place orders directly from the Admin Portal, eliminating the need to send requests via email. This update streamlines the ordering process, providing a more efficient and user-friendly experience.

    • How to access/use it from the Admin Portal
      • Navigate to the AMS menu.
      • Select the new "Baremetal Instances" menu.
      • Click "Order new instance."
      • Choose your desired Baremetal option from the available list.
      • Click "Continue - Send Order Request."
      • You will receive an automatic email summarizing your order.
    • How to access/use it from SDK
      • N/A

  • New Bulk Unlock Endpoints for Non-Incremental Achievements
    We have introduced new endpoints that allow bulk unlocking of non-incremental achievements in a single request. This enhancement reduces the number of API calls required, eliminating the need to send multiple requests one by one.

Deprecated and Decommissioned Features​

  • REMINDER FOR UPCOMING DECOMISSIONING!!

    • The endpoints listed below will be decommissioned by AGS version 2025.4.
      • Please make sure you have transitioned to use the listed alternatives before AGS version 2025.4 releases.
        • Endpoints:
          • /iam/namespaces/{namespace}/users/byLoginId
            • Alternative endpoint(s): /iam/v3/public/namespaces/{namespace}/users
          • /iam/namespaces/{namespace}/users/byPlatformUserID
            • Alternative endpoint(s):
              • /iam/v4/public/namespaces/{namespace}/platforms/{platformId}/users/{platformUserId}
              • /iam/v3/admin/namespaces/{namespace}/platforms/{platformId}/users/{platformUserId}
          • /iam/namespaces/{namespace}/users/listByLoginIds
            • Alternative endpoint(s):
              • /iam/v3/public/namespaces/{namespace}/users/platforms
              • /iam/v3/admin/namespaces/{namespace}/users/search/bulk
          • /iam/namespaces/{namespace}/users/{userId}
            • Alternative endpoint(s):
              • /iam/v4/public/namespaces/{namespace}/users/{userId}
              • /iam/v3/admin/namespaces/{namespace}/users/{userId}
          • /iam/namespaces/{namespace}/users/{userId}/platforms
            • Alternative endpoint(s):
              • /iam/v3/public/namespaces/{namespace}/users/{userId}/platforms
              • /iam/v3/admin/namespaces/{namespace}/users/{userId}/platforms
          • /iam/v2/public/namespaces/{namespace}/users/{userId}
            • Alternative endpoint(s):
              • /iam/v4/public/namespaces/{namespace}/users/{userId}
              • /iam/v3/admin/namespaces/{namespace}/users/{userId}
          • /iam/v3/public/namespaces/{namespace}/users/{userId}
            • Alternative endpoint(s): /iam/v4/public/namespaces/{namespace}/users/{userId}
          • /iam/v3/public/namespaces/{namespace}/platforms/{platformId}/users/{platformUserId}
            • Alternative endpoint(s): /iam/v4/public/namespaces/{namespace}/platforms/{platformId}/users/{platformUserId
          • /iam/v3/public/namespaces/{namespace}/users/bulk/basic
            • Alternative endpoint(s): /iam/v3/public/namespaces/{namespace}/users/platforms
        • Minimum SDK versions supporting the alternative endpoints:
          • Unreal Engine: 26.7.0
          • OSS: 0.12.31
          • Network-Utilities: 4.4.1
          • Unity: 17.5.0
          • P2P Unity: 0.3.14

  • DEPRECATION AND DECOMMISSIONING PLAN FOR SLOT (CLOUD STORAGE) AND GAME PROFILE

    As part of our ongoing platform optimization, and given that we have not detected any usage of the Slot (Cloud Storage) and Game Profile features in the past two months, we are initiating their deprecation and eventual removal from our Social service. Additionally, we have introduced new features that can effectively cover the use cases previously handled by these deprecated features.

    Starting with this AGS version 2025.2, these features will be marked as deprecated, with our Social service now focusing solely on providing Statistics functionality. The affected features will remain functional until their complete decommissioning.

    • Slot (Cloud Storage)
      • We recommend migrating to Player Binary Records as an alternative. Please refer to the documentation for more details.
    • Game Profile
      • We recommend migrating to JSON Player Records as an alternative. Please refer to the documentation for more details.
    Affected endpoints

    The affected endpoints will be fully decommissioned in AGS version 2025.5.

Minor Changes​

  • Admin Portal
    • Improved the Goal requirement grouping design when managing Challenge Goals in the Admin Portal.
    • Added an SKU column to the User Entitlements table for easier item referencing.
    • Updated labels that still referred to "Oculus" to "Meta Quest."
    • Improved the condition to allow the admin during login to redirect to their last visited page before their session expired
    • Improved and standardized the date & time format across the Admin Portal to use the MM/DD/YYYY & 24-hour format
  • AMS
    • Minor UI change in the Baremetal “Learn more” section
  • IAM
    • Added `jti` field in IAM access tokens & in the logout event (/logout API).
    • Improved account deletion scheduler, to prevent an edge case where multiple pods could attempt to run deletion for the same user data, resulting in a false positive alert (i.e. deletion job failed, even though the user is deleted successfully).
    • For logins with `grant_type` \= `authorization_code`, the client’s source IP will now be obtained from the /v3/oauth/authorize endpoint.
  • GDPR
  • Challenges
    • Improved the latency of the list user rewards endpoint.
  • Matchmaking
    • Canceling a match ticket will also cancel the matchmaking process, so the player will not receive a match-found notification.
  • Chat
    • Users in chat now receive notifications regarding topic deletion.
  • Platform
    • The Account Upgrade flow will now only return Virtual Currency wallet balances if there is a transaction history.
  • Player Portal
    • Updated the Local Device icon to the new one
    • Improved the error message where the account linking failed during the upgrade headless account process
  • Statistics
    • Enhanced the Statistics Cycle reset process to ensure cycles reset properly, even if there is a service disruption during the reset.
    • Optimized the bulkUpdateUserStatItems and bulkIncUserStatItems endpoints to process each item concurrently.
  • Session History
    • Improve the session history data to add more information for supporting the new UI

Bug Fixes​

  • Admin Portal
    • Fixed an issue where Goal data was not displayed for Challenges with Rotation Type set to None.
    • Fixed the “Available from” and “Expiration Date” value displayed too short on the Store page
    • Fixed the Start and End time value always displayed by -7 hours on the Store page
    • Fixed the Contents Creators table not refreshed when pagination is updated in the creator detail page
    • Fixed a bug where the admin unable to update JSON configuration and access type on the player record detail page
    • Fixed a bug where the admin was unable to add a redirect URI without specifying the top-level domain (TLD) in 3rd Party Configuration - Auth & Account Linking
    • Fixed searching in the Access Logs using the path filter may show unrelated results
    • Enable Scrolling in Store’s Extensions JSON Preview
    • Fixed a bug where an incorrect unit of time is sent in the payload when creating/editing the Override Expiration Time for an IAM Client.
  • AMS
    • Fixed an issue where the Server Image list in the Fleet Creation does not show more than 100 Images
    • Fixed an issue where the Grafana Dashboard does not display AMS Overview data
    • Fixed an issue where modifying the timeout values during Fleet Creation will prevent the Fleet from being created
    • Fixed an issue where the changes made to artifacts and logs will be reverted if the status of the Fleet is changed immediately
    • Fixed an issue where updating Fleet artifact and log sampling rules is not immediately tracked in the audit log
  • Challenges
    • Fixed an issue that prevented Game Admins from creating or updating Reward Goals with decimal values.
  • Chat
    • Fixed issue querying chat topic with member cache
  • Inventory
    • Fixed an issue where deleted items from the Store could not be removed and caused errors on Get endpoints.
  • Login
    • Fixed the capital letter B in “Xbox”
  • Lobby
    • Fix a bug where the player unable to login in to a different device
  • Matchmaking
    • Fixed bug in the pagination in the endpoint /match2/v1/namespaces/{namespace}/match-functions when querying match function data.
  • Player Portal
    • Fixed some localization strings that still mention hardcoded “Local device” instead of the custom value from the localization JSON file
    • Adjusted the table font size to 16px in some menus under the My Accounts page
    • Fixed the Local device icon size in the My Account - Linked Accounts page
    • Added a new localization string “Local Device”
  • Sessions
    • Fix a bug where the textChatMode able to be tampered with lowercase value
に最終更新

On this page