AGS 3.80.0 Release Notes

Last updated on December 19, 2024

Release date: December 27th, 2024

Versions

AccelByte Gaming Services (AGS) Game SDK

To ensure we deliver the best quality, please expect the SDK to be available one week after the first deployment on Jan 13th.

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

Extend SDK

• C#
• Go
• Java
• Python
• TypeScript

AccelByte Multiplayer Servers (AMS) CLI

• AMS CLI: 0.245.31

Highlights

• GDPR-compliant third-party account closures are now supported for Xbox and Steam.
  • In order to comply with GDPR, when a user account is deleted on a third-party platform (i.e., Xbox and Steam), the user's data will be deleted on AGS's side as well. Admins can set up a configuration for Xbox and Steam, allowing AGS to synchronize account closures done on the mentioned platforms and perform the necessary deletions on its systems.
  • How to access and use the feature in the Admin Portal:
    • Account Closures History: In your publisher or studio namespace, go to Admin Tasks > GDPR > 3rd-Party Account Closure.
    • Account Closure Configuration: In your publisher or studio namespace, go to Game Setup > 3rd-Party Configuration > Account Closure.
• Added a new time zone preference setting to the Admin Portal.
  • This allows you to select either your local time zone or one of the available UTC+ time zones for your account.
  • How to access and use the feature in the Admin Portal:
    • Go to My Account and select Preferences.
• Configure horizontal auto-scaling of Extend apps based on CPU utilization.
  • You can now configure your scaling policy based on CPU utilization to fine-tune your resource allocation and reduce costs.
  • How to access and use the feature in the Admin Portal:
    • In your publisher or studio namespace, go to the details page of your Extend app. At the top-right of the details page, click on the three-dot menu and select Settings > Auto Scaling Policy.
• Introduced the new ready-to-use Extend app: Vivox authorization server. For more information, refer to the Create a service extension app for Vivox page.
• Added two new available requirements for challenge goals:
  • Two new requirements have been introduced for challenge goals: Full Account and User Logs in with Third-party Account.
    • The Full Account requirement enables game admins to confirm whether players have registered an email address with their accounts (Upgrade into Full Account).
    • The User Login with 3rd Party Account allows Game Admin to verify if players have logged into the game using a third-party account.
  • How to access and use the feature in the Admin Portal:
    1. On the Admin Portal sidebar, go to Engagement > Challenges > Configurations.
    2. Create a new challenge configuration and create goals with the new Challenge Goal requirements.
  • How to access and use the feature through REST API:
    • Challenge/adminCreateGoal
      • Required permission: ADMIN:NAMESPACE:{namespace}:CHALLENGE [CREATE]
    • Challenge/adminUpdateGoals
      • Required permission: ADMIN:NAMESPACE:{namespace}:CHALLENGE [UPDATE]

Deprecated and decommissioned features

• Payment Callback Configuration

  • The Payment Callback Configuration feature is being deprecated in this release. A timeline on this feature's removal will be shared once available.
  • As a result of this deprecation:
    • The Commerce > Payment Callback Configuration page has been removed from the AGS Admin Portal.
    • The following endpoints are now deprecated but remain functional.
      • getPaymentCallbackConfig
      • updatePaymentCallbackConfig

• Schedule field in Challenge Goal response modal

  • The deprecation of the "Schedule" field, initially planned for AGS version 3.80, has been rescheduled to AGS version 3.81 (2025.1). For details on the original announcement, please refer to the AGS version 3.78 release notes.

Minor Changes

Platform

• Added the new iapItemConfigUpdated API event. This is sent when an AGS in-app purchase (IAP) item's mapping with a third-party platform is updated via the Admin Portal.
• The deRevocation endpoint has a new field in the request body called requestId, which is used to support idempotency when running multiple revocations for the same transaction ID

IAM

• Third-party sign up options are now supported via the one-time code link flow, alongside UX improvements to the game progression picker to allow better clarity for players to identify and choose the correct progression.
• Nonce is now supported in idToken claims.

Admin Portal

• [AGS Private Cloud] The expiration dates of business partner certificate are now shown under or next to the Business Partner Certificate fields in the following pages on the Admin Portal:
  • Game Setup > 3rd Party Configuration > Account Closure page
  • Game Setup > 3rd Party Configuration > Store page
• Improved the Config Migration Error Handler to handle issues related to dependencies during the Import Confirmation step without restarting the process.
• The checkboxes for roles that are already in the Login Allowlist are now grayed out and ticked (instead of just being grayed out) on the Add Role form to better indicate that they cannot be selected.
• Improved system performance for updating game name and status in the namespace settings.
• Improved the search capability within the namespace menu to allow searches using namespace ID.
• Improved how the total balance amount is displayed on the Usage & Billing page for Shared Cloud users to only show two digits after the comma.
• Removed the cache mechanism in the Admin Portal that fetches the namespace list from basic services.
• Added the challenge goal completed time and reward claimed time information to the Player Challenge Details page and User Progression Detail modal.
• Improved the error message that appears when the minimum and the maximum stat cycle override are configured incorrectly.

AMS

• Added the ability to download the log from live dedicated servers (DS).
• Streamlined the fleet configuration experience with a more intuitive and improved interface.
• Optimized the Admin Portal user experience for view-only users.

App Editor

• Changed the Overlay Transparency field name to Overlay Opacity on the App Editor - Twitch Drop page to give better clarity

Challenges

• Introduced new endpoints to facilitate checking and listing schedules of challenges and challenge goals. These endpoints are designed to accommodate the upcoming deprecation of the Schedule field within the goals response.
  • Challenge/adminListSchedulesByGoal
  • Challenge/publicListSchedulesByGoal
  • Challenge/adminListSchedules
  • Challenge/publicListSchedules
• Added two new requirements, userThirdPartyLoggedIn and fullAccount, to the USERACCOUNT parameter type.

Cloud Save

• Usage recommendations for endpoints have been provided on the API endpoint description to ensure optimal utilization and service performance.

Inventory

• Enhanced the logic governing the stacking of entitlement items, improving the integration between Inventory and Commerce services. As a result, the Inventory service is now better equipped to handle items with future availability, process expired items, and manage entitlements from diverse sources.

Login

• The Login website now supports account-linking logic independently from the Player Portal. This includes headless account upgrade, 2FA, and headless account linkage with an existing or new account.

Lobby

• Case-sensitive validation has been added to the metadata key attributes when sending friendship invitation requests to other players.

Matchmaking

• Added the teamID field to the game session structure.

Player Portal

• Improved the detection of invalid language code in the Player Portal's URL.

Sessions

• The Session service now sends serverClaimed notifications to the DS for custom sources.
• Added the teamID field to the game session structure.
• AddedOnSessionJoinedSecret notification to the stored notifications, which will be received by players when joining DS type sessions with theenableSecret option to true.
• Improved the game session version handling process when updating game sessions.
• Added OnSessionEnded notification when a session fails to claim a server in AMS. Players who left a session last are now notified of other session members' status changes.

TURN Manager

• Added the Bandwidth Threshold field to the auto-scale configuration to set the network threshold for scaling up or scaling down the TURN server.

Bug Fixes

Platform

• Fixed the issue where new items couldn't be added to empty bundles that were created via API.
• Fixed the issue with the Xbox and Microsoft Clawback service integration taking a long time to process or would fail.

IAM

• Fixed the incorrect Xbox platform user IDs in the Lookup Users page.

Admin Portal

• The tooltip shown during inputting a new game namespace name & updating a game namespace name will now display the correct input limitations.
• The Agreement Records menu is now correctly displayed for Shared Cloud users.
• Fixed the issue with the Draft Store table returning a 404 error when applying the Status filter.
• Fixed the issue of the search history being blocked by the LastPass extension dropdown.
• Fixed the issue where clicking a module under Custom Features didn't automatically open its first submodule.
• Updated critical NPM packages used by the Admin Portal to address security vulnerabilities.
• Fixed the issue of the challenge reset dates being displayed incorrectly for weekly challenges.
• Fixed an issue that caused the Admin Portal to freeze after entering multiple characters in certain input fields. This issue was caused by a complex regular expression that triggered catastrophic backtracking.
• Corrected the alignment of the Delete Inventory button.
• Fixed the issue of the Stat cycle field failing to refresh after a new Stat Code was selected during challenge goal configurations.
• Fixed the issue preventing the Challenge Preview page from being closed when using the Escape key.
• Fixed the issue of the Challenge tab being missing from the User Management page on the Admin Portal for Shared Cloud users.
• Fixed the issue preventing game admins from setting a challenge reset time that is more than one hour from its start time.

Legal (Agreements)

• Fixed an issue where the bulkAcceptVersionedPolicy endpoint took a long time to respond.

AMS

• Fixed a broken link to the AGS documentation.
• Added the missing creation date information to the API response for development configuration listing.
• Fixed the issue with the Fleet Server history not returning accurate data when filtered by status.

Analytics

• Fixed the issue causing S3 files to be corrupted in environments with multiple connectors (i.e., connector-v1 and connector-v2).
• Fixed JSON parsing error issue on GameSight.

Challenges

• Fixed an issue where fixed challenges couldn't advance to the next rotation period when the period doesn't have any set goals. The challenges would revert to the previous period as a result. Now, fixed challenges can advance to a rotation period without any set goals.

Extend

• Fixed the issue of Extend apps missing environment variables when redeployed.
• Fixed the image vulnerability scanning result messages to align with scan results.

Inventory

• Fixed the issue where the Inventory service generated slot IDs containing uppercase letters.

Matchmaking

• Fixed the issue where the game session can have the same key attributes without case-sensitive validation.
• Fixed the issue of the matchmaking rate (MMR) and latency weight not being defined in Match Ruleset in the matchmaking process.

Player Portal

• Fixed the issue where players couldn't update their display names containing the $ symbol.
• Fixed the issue where the Validation endpoint does not get called by the Player Portal when theuniqueDisplayName envar is enabled.
• Fixed the issue on the Legal page where selecting different documents within a legal group always redirected to the first country in the group.
• Fixed a display bug in legal documents where the new version banner was covered by the user email verification banner.
• Fixed the issue of incorrect error messages being shown when a player enters a redeem code for an entitlement that they already own.
• Fixed the issue of the Save changes button always being grayed out on the My Profile page when USERNAME_DISABLED envar is set to TRUE.
• Fixed an issue that caused newly created accounts to default to the wrong language, even if a specific language was selected during account creation.
• Updated critical NPM packages used by the AccelByte Publishing Toolkit (APT) services to address security vulnerabilities.

Sessions

• Fixed the issue of the native session sync not being triggered when the player status has been changed to DROPPED.
• Fixed the issue where the game session can have the same key attributes without case-sensitive validation.