Leaderboards and Tournaments Release Notes

Amazon Leaderboards and Tournaments provides frequent incremental releases to introduce new capabilities and to provide fixes for issues.

Name changed from GameOn to Leaderboards and Tournaments

Also, GOTO changed to Tournament Organizer

October 22, 2020

Release 20190712

July 12, 2019

Leaderboards and Tournaments Console

UI improvements and bug fixes.

Game API

Get Tournaments - new field playersEntered in the response.
Get Tournament Details - new field playersEntered in the response.

Release 20190523

May 23, 2019

Leaderboards and Tournaments Console

UI improvements and bug fixes.

Game API

Minor bug fixes.

Leaderboards and Tournaments Tournament Organizer

UI improvements and bug fixes.

Release 20190509

May 9, 2019

Leaderboards and Tournaments Tournament Organizer

UI improvements and bug fixes.

Leaderboards and Tournaments Console

UI improvements and bug fixes.

Release 20190425

Apr 25, 2019

Leaderboards and Tournaments Tournament Organizer

Streamers can now ban and remove players.
UI improvements and bug fixes.

Release 20190411

Apr 11, 2019

Leaderboards and Tournaments Tournament Organizer

Streamers can now create tournaments based on stats.
Introduced a toggle to enable auto-refresh on the Leaderboards and Tournaments Tournament Organizer leaderboards.
Updated UX for granting permissions on the Leaderboards and Tournaments Tournament Organizer
UI improvements and bug fixes

Leaderboards and Tournaments Console

Developers can add stats to the allow list for the Leaderboards and Tournaments Tournament Organizer on the Game Configuration page.

Release 20190315

Mar 15, 2019

Leaderboards and Tournaments Console

Introducing Leaderboards and Tournaments Stats-based Leaderboards which allows developers to manage stats for games and have them ranked in competition leaderboards
UI improvements and bug fixes

Game API

New attributes on existing APIs to support Leaderboards and Tournaments Stats-based Leaderboards feature. For details, see Stats-based Leaderboards

Leaderboards and Tournaments Tournament Organizer

Streamers now can customize Leaderboards and Tournaments Tournament Organizer extension to fit their themes
UI improvements and bug fixes

Release 20190306

Mar 6, 2019

Game API

Modified the following endpoints to return errorCode in the response in case of errors. This is to allow games to identify different error cases that result in the same HTTP status code.

Release 20190228

Feb 28, 2019

Game API

Pagination is now enabled in GetPlayerTournamentList. You can use the "next" field to retrieve the next page of results. For details, see Get Player Tournaments
TournamentState can now return a new value of WAITING_TO_BE_PROCESSED to signify when a tournament has ended and is waiting to be closed/completed. For details, see GetDeveloperTournamentListResponse, GetDeveloperTournamentDetailsResponse, GetMatchListResponse_PlayerGeneratedMatch, GetPlayerTournamentDetailsResponse, GetPlayerTournamentListResponse_Tournament
Added a new getMatches filterBy value for awaiting-process to return matches for tournaments in a "WAITING_TO_BE_{PROCESSED/CLOSED/COMPLETED}" state. For details, see Get Matches

Leaderboards and Tournaments Tournament Organizer

Leaderboards and Tournaments Tournament Organizer Twitch extension now supports profanity filters on competition titles

Release 20190214

Feb 14, 2019

Leaderboards and Tournaments Tournament Organizer

Minor bug fixes

Release 20190129

Jan 29, 2019

Tournament Organizer

Tournament Organizer Twitch extension can now deep link to games in your player's Steam library. For details, see Deeplinking to Steam
Tournaments can be pinned to show up as the default tournament. Streamers will be prompted during first time setup and provided reminders when they set up tournaments.
Number of players in a tournament now auto-refreshes along with leaderboard results
New time and date picker
Cursor effects and tool tips added for improved usability

Leaderboards and Tournaments Console

Games can be tested in the extension, if it is on the allow list, prior to going live
Developers can restrict the creation of tournaments to a desired list of streamers with the new streamer allow list feature
Developers can impose limits on tournaments created in the extension, including tournament duration, max players, and max attempts per player
Players and streamers can be banned from participting in tournaments and creating tournaments in the extension
Players and streamers can be removed from leaderboards

Release 20190115

Jan 15, 2019

Game API

Improvements in latency for all tournament related APIs such as Submit Score and Get Tournaments.

Release 20190111

Jan 11, 2019

Game API

Bug fix where canEnter flag was being returned as true in certain cases for GetTournamentListResponse_Tournament and GetDeveloperTournamentDetailsResponse when the tournament was full.

Release 20190103

Jan 3, 2019

Admin API

New API to delete an in-app prize. For details, see Delete Prize

Leaderboards and Tournaments Tournament Organizer

UI improvements and bug fixes
Tournament details include two new fields creatorPlayerName and creatorPlayerIconUrl for tournaments created through the Tournament Organizer Twitch extension. For details, see Tournament Organizer API Reference

Release 20181204

Dec 4, 2018

Leaderboards and Tournaments Console

Usability and selection/copy enhancements on Prize List page
Minor improvements and bug fixes

Release 20181120

Nov 20, 2018

Leaderboards and Tournaments Console

Added In-App Prize Management on Admin Console. For details, see Manage Prizes
Minor improvements and bug fixes

Leaderboards and Tournaments Tournament Organizer

Minor improvements and bug fixes

Release 20181106

Nov 6, 2018

Game API

Added prizeBundleClaimStatus field to the response of GET /matches API.

Leaderboards and Tournaments Console

Moved various settings into advanced options in Create Competition on Admin Console. Some fields on that page are now optional.
Minor improvements and bug fixes.

Release 20181025

Oct 25, 2018

Leaderboards and Tournaments Tournament Organizer

New API methods to provide Tournament Organizer capability. For details, see Tournament Organizer Overview

Release 20181023

Oct 23, 2018

Leaderboards and Tournaments Console

You can now create Team Competition from the console. For details, see Manage Team Competitions
Miscellaneous minor bug fixes.

Admin API

You can create a tournament series using the admin API. For details, see Add Tournament Series

Release 20181009

Oct 09, 2018

This release includes updates to the Game API, Admin API, and Leaderboards and Tournaments Console to support Country Restrictions. For details, see Country Restrictions.

Admin API

Updated methods:

Add Requirement List - new type of Requirements List, RequirementsListType_Contains.

Game API

Updated methods:

Get Tournaments - new fields description and tournamentState in the response.
Get Player Tournaments - new fields description and tournamentState in the response.
Get Leaderboard - you can now retrieve a leaderboard (top n participants in a match) without having a player in that match.

Leaderboards and Tournaments Console

When you create a new competition, the new Countries panel allows you to limit the competition to specific countries or Amazon marketplaces.
In the Tournament Details display, the Countries panel lists the selected regions and countries.

Release 20180927

September 27, 2018

This release includes new and updated capabilities to support team competitions.

Admin API

New methods:

Updated methods:

Add Tournament - new parameter to set tournament as Individual or Team.

Game API

New methods: None.

Updated methods:

Get Tournaments - new filters to get team tournaments.
Enter Tournament - new teamId parameter for team tournaments.
Get Leaderboard - now includes team leaderboards.
Get Match Details - now supports teams

Release 20180912

September 12, 2018

Admin API

imageUrl for the following requests don't allow these special characters: <>"/\%&;=^*{}?#()+: for security reasons.
name, description and key and value in the following requests don't allow these special characters: <>"/\%&;=^*{}?#()+: for security reasons.

Leaderboards and Tournaments Console

Miscellaneous minor bug fixes.

Release 20180828

August 28, 2018

API

Enabled CORS (Cross-Origin Resource Sharing) for Game API.

Leaderboards and Tournaments Console

Miscellaneous minor bug fixes.

Release 20180815

August 15, 2018

API

For the games that are registered with longer cryptographic keys:
- "Register Player" request requires encrypting the client public key (encryptedPayload) with OAEP and mandates the client public key to be at least 2048-bit.
- Player token (encryptedPlayerToken) in the "Register Player" response is now encrypted with OAEP.
- Above changes are applicable to "Register Player with vendorPlayerId" request and response too.
- "Auth Player" request requires encrypting the player token (encryptedPayload) with OAEP
- "Claim Prizes" response has a new field called "encryptedPrizeInfoV2" that returns the prize info encrypted with OAEP.
- Similarly, "Fulfill Prizes" response also has a new field called "encryptedPrizeInfoV2".
Cryptography code samples to encrypt/decrypt with OAEP can be found here.

Leaderboards and Tournaments Console

Registering a game with advanced security now generates longer (4096-bit) public and private key pair.

Release 20180731

July 31, 2018

Leaderboards and Tournaments Console

Prize Bundles can now be set up from Leaderboards and Tournaments Console, including the ability to specify optional fields such as ImageUrl and Description. See instructions to add prize bundles to a competition for more details.

Release 20180720

July 20, 2018

Leaderboards and Tournaments Console

Fixed an issue that limited the number of prizes that can be associated with a competition
Fixed an issue where Tournament Details screen would encounter an error if no one entered the competition and the competition was closed
Miscellaneous UX styling enhancements
Miscellaneous minor bug fixes

Release 20180703

July 3, 2018

Leaderboards and Tournaments Console

ImageURL can now be specified for a competition from the Leaderboards and Tournaments Console.
Miscellaneous minor bug fixes.

Release 20180620

June 20, 2018

Leaderboards and Tournaments Console

Valid AWS account now required to register new games and to continue operating your existing games. Go to the Game Settings page to add or change your AWS account, or to view your bill. See Billing Overview for more details.
Improved prize selection during competition creation. The Prizes dropdown now shows Prize ID (first five characters) on the second line below the Prize Title. You can also search the prizes by Prize ID by typing/copying it fully or partially.

Release 20180606

June 7, 2018

API

The Create Tournament admin API will no longer allow creating tournaments with special characters (such as <>\%&;^*?#()) for tournament metadata. The alternative is to use Base64 encoding.
Fixed a bug where a player’s prize claim status is stuck in “Unclaimed” state even after claiming the prize, due to a race condition.

Leaderboards and Tournaments Console

Tournaments can now have a start date in the past.
Tournaments can now have an end date greater than one year in the future.
Clarified that the competition start times and end times are entered and displayed as local times.

Release 20180601

June 1, 2018

API

None

Leaderboards and Tournaments Console

Fixed a bug where trying to create a competition with real world prizes caused errors in some circumstances.

Release 20180522

May 22, 2018

API

The field advertisingId was deprecated from our systems. It is no longer required when creating a tournament.
Added a restriction that tournaments must end two days before the expiry date of any real world prize.

Leaderboards and Tournaments Console

Tournament list and details pages now display number of players and scores submitted per competition
When adding prizes to a competition, the UI will filter out any real-world prizes that expire within two days from the tournament end.