AGS 2025.3.0 Release Notes

Last updated on May 2, 2025

Release date: May 2nd, 2025

Announcements​

AMS Release Notes Now Available Separately​

Starting with this release, all updates related to AccelByte Multiplayer Servers (AMS) will be documented in a dedicated AMS Release Note. This allows us to provide more detailed and focused updates specific to AMS features, improvements, and fixes.

You can view the latest AMS changes here:

🔗 View AMS Release Notes

Versions​

AccelByte Gaming Services (AGS) Game SDK​

To ensure the highest quality, the Game SDK is scheduled for release on May 13th, 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​

Highlights​

  • New leaderboard support retrieve previous cycle data

    The leaderboard system has been enhanced to support retrieving data from previous cycles. Previously, the leaderboard only displayed data from the current active season. With this update, users can now access leaderboard data from past seasons, enabling better historical comparison, performance tracking, and season-over-season analysis. This improvement enhances the visibility and usability of the leaderboard, especially for competitive or recurring events.

    • How to access/use it from the Admin Portal
      • On the Admin Portal sidebar, go to Engagement > Leaderboard
      • Choose one of the leaderboard code
      • On player data table, choose the cycle code
      • Previous data of leaderboard cycle can be retrieved by changing the Active Season to Previous Season on the dropdown
    • How to access/use it from SDK
      • No SDK functionality
    • How to access it through REST API
      • There is a new parameter in get cycle leaderboard data, both admin (/leaderboard/v3/admin/namespaces/{namespace}/leaderboards/{leaderboardCode}/cycles/{cycleId}) and public (/leaderboard/v3/public/namespaces/{namespace}/leaderboards/{leaderboardCode}/cycles/{cycleId}), called previousVersion.
      • Users can access up to 1 version prior to the current version, by providing value to previousVersion parameter.
      • The default value would be 0, meaning that the endpoint will return the current version.

  • Option box support item type: Code

    Previously, Option Boxes could only contain direct item types such as in-game items or currencies. With this update, developers can now include Code as an item type inside an Option Box.

    • How to access/use it from the Admin Portal
      • Make sure the code is already configured in the draft store.
      • On the Admin Portal sidebar, go to Commerce → Store, click view the draft store.
      • Create new item and choose item type: Option Box
      • Fill out the rest of attributes, like name, SKU and other attributes. And click Next.
      • Click Add Item to input the content of the Option box. The item types should support Code as the content of the option box.
    • How to access/use it from SDK
      • No SDK functionality
    • How to access it through REST API
      • No changes are required when a user consumes the option box through the REST API.

  • Inventory support emit event when saving item

    Previously, saving an item to a player's inventory was an isolated operation with no external notification. With this enhancement, the Inventory service now emits a Kafka event whenever an item is saved.

    This event can be consumed by external systems, such as an Extend Event Handler, to enable flexible and customizable features.

    • How to access/use it from the Admin Portal
      • Not available
    • How to access/use it from SDK
      • No SDK functionality
    • How to access it through REST API
      • Not available

  • Support adjust goal of the TIED Challenge

    Previously, once a Challenge became tied—meaning a player had started progressing on it—its configuration was locked and could not be modified. This limitation has now been lifted.

    With this update, you can adjust the goal of an active (tied) Challenge to better accommodate changes such as balancing adjustments, difficulty tuning, or correcting configuration errors, without impacting existing player progress. Note that it is only applicable to fixed challenge types and the goal’s period has not yet started.

    • How to access/use it from the Admin Portal
      • On the Admin Portal sidebar, go to Engagement → Challenge → Configuration, then choose one of the already in progress challenges.
      • Click tab Goal & Rewards, then choose one of the goals by clicking the triple dot button on the left of the table and click View.
      • It is now able to update goal progression.
    • How to access/use it from SDK
      • No SDK functionality
    • How to access it through REST API
      • For goals that are part of a fixed challenge, users can use the existing update goal endpoint (/challenge/v1/admin/namespaces/{namespace}/challenges/{challengeCode}/goals/{code}) to update TIED challenge.
      • Users cannot edit goals that already started/passed.

  • Introduced a new centralized hub for tracking the progress of issues and features your organization has raised through the Support Portal (ASP) called Request Tracker.

    • How to access/use it from the Admin Portal
      • On the Admin Portal sidebar, click the Request Tracker
    • The feature is now limited for Private Cloud Customers

  • Introduced export functionality for Audit Log

    • Where to find in the Admin Portal:
      • On the Admin Portal sidebar: Development Utilities → Logs → Audit Logs → Export Logs

  • [Unreal Engine] Added the following API interfaces to ServerEcommerce to support fetching Player’s Wallet from the Server API:

    • QueryUserCurrencyWallets
    • DebitByWalletPlatform
    • ListUserCurrencyTransactions
    • GetPlatformWalletConfig
    • UpdatePlatformWalletConfig
    • ResetPlatformWalletConfig
    • GetWalletConfig
    • UpdateWalletConfig
    • CheckBalance

  • [Unity] Added Game Standard Event for Server SDK. This feature can be accessed from ServerRegistry.GetGameStandardEvents()

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

  • [Unreal Engine] To ensure the quality of our service performance, we have deprecated SessionHistory::QueryGameSessionHistory and UABSessionHistory::QueryGameSessionHistory from Unreal SDK.

    This functionality will be removed in AGS version 2025.4.

    Our recommended approach for accessing session history is via Admin Portal > Multiplayer > Session History

  • [Unreal Engine] Removed bMultipleLocalUsersEnabled config and IsMultipleLocalUsersEnabled() function which are now obsolete with the introduction of AccelByteInstance

Minor Changes​

Admin Portal​

  • Added PSN Disable System UI field in a session template edit page, in 3rd Party Sync tab → Playstation.
  • Added Applied Alliance Rule hyperlink to the matchmaking history X-Ray detail page that will display the active ruleset during the match ticket events.
  • Added a refresh button to the Matchmaking X-Ray Overview page to fetch the latest data without refreshing the whole page.
  • Updated the overall copy messages around Admin Tasks - Email Configuration menu
  • Replaced the “Cancel Subscription” terminology to “Deactivate” for AMS & Extend products across the Shared Cloud Admin Portal for better clarity
  • Revamped the overall Shared Cloud Registration UI/UX and minor improvements to our Onboarding experience.
  • Added Cloud Save functionalities to the Player Record tab under the Lookup Users menu in Shared Cloud
    • View the player’s Binary Records from the Binary tab.
    • Add button to add new Player Record.
    • Action button in the list to view and delete Player Records

Audit Logs​

  • Added sort functionality to Audit Logs.
  • Added additional filter options, user display name & client name.

IAM​

Challenges​

  • Challenge service performance improvement on evaluate endpoint

Extend​

  • Minor UI change in Extend App Description
  • App status will be set as undeployed every time the appConfig variable changes to avoid confusion
  • Running/Active Image will be automatically selected when doing the Config Migration
  • Skip the Variable and Secret variable which automatically created by CSM during the Config Migration process
  • Block the starting or deploying app process when there is no image uploaded

Group​

  • Improve consistency when dealing with database replica lag.

Inventory​

  • Improve consistency when deleting multiple inventory.
  • Adjust save item API docs to explain the endpoint behavior.

Friends​

  • Improve the native sync to exclude the blocked player from being synced

Matchmaking​

  • A new endpoint was added to get the match function by name: /match2/v1/namespaces/{namespace}/match-functions/{name}
  • An improvement was added to prevent a mismatch of the maximum number of players in the match ruleset and session.

Player Portal​

  • Adjusted the default selection of linking account from “Link Account” to “Sign Up” tab in Link Account page

Seasonpass​

  • Configurable access control when accessing get current season endpoint

Sessions​

  • A new field was added to the session template to configure PSN DisableSystemUIMenu (optional). This field will be used to fill disableSystemUiMenu parameter for createPlayerSessions in PSN.
  • Players will receive an OnSessionJoinedSecret notification when joining a session with the secret validation enabled.
  • The active hanging sessions are now deleted when the session template is deleted.
  • Adding DS_CANCELLED as the new filter in the session

Chat​

  • Improve the session notification to ignore outdated events

Session history​

  • Adding order to sort in the search by userID
  • Adjust the session history pages to add the request client ID field
  • Adding filter by DS Statusv2

UGC​

  • Configurable access control when access get content downloader endpoint.

Game SDK​

  • [Unreal Engine] Moved DeviceID cache location on Editor, from content to saved directory.

Bug Fixes​

Admin Portal​

  • Bug fix in User Entitlement page:
    • Fix issue that item code detail showed an empty granted code.
  • Bug fixes in Sessions & Parties page:
    • Fixed some filters to display the data
    • Fixed a bug in Last Update data that prevented it from being displayed with the value from the Session data instead of the current time.
    • Fixed a bug in Persistent status that prevented it from being displayed with the current value after the session is deactivated.
  • Fixed Missing Optional Indicator for non-mandatory fields in Add Configuration modal in “3rd Party Store Integrations” menu
  • Fixed No clear indicator of user unable to delete item pricing on draft store
  • Fixed A display issue when a namespace name is too long in Namespace list menu
  • Fixed the timezone preference when editing player’s DoB in Look-up User menu
  • Fixed improper info where the unlock limit for AGS displays AMS usage information in Shared Cloud Admin Portal
  • Fixed query user with value more than 20 characters will return as empty data
  • Fixed wallet table for source column wide
  • Fixed invalid email validation target when admin change user email in Look-up User menu
  • Fixed Some data type in metadata will break the Wallet History
  • Fixed the Date & Time format in Store menu
  • Fixed the Start & End date auto-filled issue in Store menu upon creating a new display rotation
  • Fixed the double scroll bar when global alert or mobile view alert shows up in the Admin Portal header

Analytics​

  • Fix issue where shared cloud able to add more than 2 connector

App Editor​

  • Removed out-date twitch drop documentation hyperlink

Extend​

  • Fix issue where the Extend admin portal page only shows 25 variables

Inventory​

  • Fix empty item types in admin bulk update item endpoint.

Email template​

  • Fixed email title typo on AMS Welcome Email

Player Portal​

  • Fixed Legal document styling for link and strong tag
  • Fixed "Email already used/exist” error displayed as a blank on the account registration flow
  • Fixed Header sidebar will not scroll until the legal document finishes scrolling and the entire page starts scrolling
  • Fixed Certain HTML styles that make Legal Docs not clearly visible or use inappropriate colors
  • Fixed Heading hyperlink leads to the wrong location on the legal document page in the Player Portal
  • Fixed error during the reset password if using special characters
  • Removed the unused ‘'Learn More’' string from 2FA localization
  • Fixed Truncated long email address on smaller screen size in Email MFA verification page
  • Fixed Unique display name field doesn't trigger proper error text when using custom regex
  • Fixed the missing input validation error when input the same characters in a row for Password during the account creation process

Sessions​

  • Fix issue when the game session does not send client secret when restoring game session
  • Fixed a bug where a player reconnecting to a party as the only connected member is not promoted as a party leader.
  • Fixed a bug where the field updatedAt is not displayed correctly in the response body when a player joins a game session by code.
  • Fixed an issue where the matchmaking process with the auto-join is enabled and reaches max active session value will be stuck and the match ticket will be expired.
  • Fixed an issue where the query game session using the filter DS_CANCELLED in the StatusV2 field will not return the expected value.
  • Fix sync xbox business cert API

Session history​

  • Fix sorting get all matchmaking history
  • Fix issue where the filter configurationName is not working
  • Fix multiple party disconnected event being recorded in session history

Chat​

  • Fix issue where player able to add clan outsider user into the clan topicID
  • Fix issue where member able to quit from clan topicID directly using websocket command

Platform​

  • Fix an issue that save item with type APP in publisher namespace return error.

Game SDK​

  • [Unreal Engine] Fixed an issue where Login with DeviceId via Play-in-Editor (PIE) always created a new user account.

    DeviceId will be generated in deterministic order so accounts can be re-used.

    To generate a fresh DeviceId, please delete the AccelByteGeneralCache file from the Saved directory.

  • [Unreal Engine] Changed all global instances of FString to TCHAR for better portability across different platforms.

  • [Unreal Engine] Fixed an issue affecting memory integrity.

  • [Unity] Fixed exception issue of Api.Basic.GetUserAvatar when target user has empty avatar.

Last updated on

On this page