v25.10.08: Factions, Quests and Badges

What's Changed

✨ Features

• Badges!
  • A list of all badges can be obtained with the badges query, and player-specific badge progress can be obtained using the badges field on a Player instance.
  • Badge information includes the name, stages, and the goal of the badge.
  • The goal is a union type that is either a specific statistic, or a general goal with a name.
  • The availability of player-specific badges information is tied to the "Statistics" API setting.
• Quests!
  • A list of the players currently active quests can be obtained using the quests field on a Player instance.
  • Quests have a type, rarity, boost type, completion state and tasks.
  • The progress of tasks is stored in the standard ProgressionData type.
  • The availability of quest information is tied to the new "Progression" API setting.
• Factions!
  • Players now have a factions field that returns a list of all factions, their associated progress and if the faction is the currently selected one for a player.
  • The new factionLeaderboard query returns a list of all factions ranked by the global amount of Faction XP earnt for that faction. This information is stored in the new GlobalLeaderboardEntry type.

Full Changelog: v25.09.23...v25.10.08

v25.09.23: Island Exchange and auction listings

What's Changed

✨ Features

• Added queries to fetch active Island Exchange listings and active auctions.
• Added query to fetch the last 24h of sold Island Exchange listings.
  Note that this will only start displaying data from now onwards, and won't show listings sold before this update.
• To represent items that can be sold in the Island Exchange and auctions, a new Asset interface has been added.
  • This represents any item that exists on MCC Island, from Cosmetics to MCC+ Tokens and beyond.
  • Every asset has a name, rarity and a unique identifier that will be consistent for the lifetime of that asset (for example, if we change the name of a cosmetic, it will return the same unique identifier after the change).
  • Some assets are already represented in the API, such as fish and cosmetics. These types implement the new asset interface will be returned in place of the asset where appropriate.
    This means you can use standard GraphQL inline fragments for advanced querying.
  • Two new types of asset have been added:
    • CosmeticToken which provides the cosmetic held in the token using the cosmetic property.
    • SimpleAsset for all other assets that do not have a more concrete type in the API yet.

🔧 Changes

• Fetching the player from a leaderboard entry will now never return null if the rank is <= 10.
  This means the Top 10 of any leaderboard will have no "anonymous" entries.

Full Changelog: v25.08.07...v25.09.23

v25.08.13: Leaderboard and hair bug fixes

What's Changed

🐛 Fixes

• All hair cosmetics now correctly return 0 Trophies.
• Fixed an issue that was causing all leaderboards to be offset by 1.
• Fixed an issue that was causing leaderboards with offsets specified to be cut off past rank 50.

Full Changelog: v25.07.17...v25.08.13

v25.08.07: Leaderboard pagination, Style Level and cosmetic additions

What's Changed

✨ Features

• Added offset parameter to the leaderboard method for statistics (#10).
  This allows you to offset the returned entries by a given number of places. For example, calling the method with an offset of 5 will return values from 6th place onwards. The maximum values of the offset field is currently set to 50.
• Added obtainmentHint to cosmetics (#27).
  This returns same text displayed in the wardrobe when a player has not obtained a cosmetic yet.
• Added styleLevelData on the CrownLevel type to view information about a player's Crown Level (#43).
• Added the CosmeticType enum to display the different types (or tags) for cosmetics (#34). This can be obtained using the type field on cosmetics.
  This also allows you to determine what cosmetics are tradable by checking their type.

🔧 Changes

• The leaderboard method for statistics has been adjusted slightly.
  • The maximum value for amount has been raised to 50.
  • The returned list of leaderboard entries will no longer be capped at amount if there are players who are tied for placement values
    For example, if two players are tied for 10th place and you call the method with an amount of 10, there will be 11 entries returned.
  • A note has been added that the maximum values for both the amount and offset fields may be changed based on performance and user feedback.
• The previously deprecated silver and materialDust fields on Currency have been removed.

🐛 Fixes

• Fixes an issue that was causing Royal Reputation to return the less than it should for some users.

Full Changelog: v25.07.17...v25.08.07

v25.07.17: Post Season 5 bug fixes

This release is a bug fix release that contains the following changes and fixes:

• Removed currencies are now deprecated for removal and will return 0 until removed (#36)
• Fixed an error on fetching server categories (#37)
• Fixed fetching equipped cosmetics returning blank (#39)
• Fixed royal reputation data returning blank (#38)
• Fixed GraphiQL being offline

v25.07.09: Cosmetic Royal Reputation information

What's Changed

✨ Features

• Added RoyalReputation type, accessible from royalReputation on Cosmetic.
  • Will return null if the cosmetic cannot be donated, mirroring canBeDonated.
  • Provides two fields, donationLimit and reputationAmount for accessing data about how many of the cosmetic can be donated and how much reputation is granted for each donation respectively.

Full Changelog: v25.03.13...v25.07.09

v25.03.13: Cosmetic description

What's Changed

✨ Features

• Added description to Cosmetic.

Full Changelog: v25.02.10...v25.03.13

v25.02.10: Global fish/cosmetic data and fish selling price

What's Changed

✨ Features

• Added sellingPrice method to Fish to allow querying the number of A.N.G.L.R. Tokens a fish with a given weight sells for.
• Added methods/fields to query the global state of fish and cosmetics.
  Both of these methods return a String containing the number of players who own this cosmetic. If this number is over 10000 or 1000 then the value returned will be 10000+ and 1000+ respectively.
  • Added globalNumberCaught method to Fish to allow querying the total number of players who have caught this fish with a given weight.
  • Added globalNumberOwned field to Cosmetic to allow querying the total number of players who own this cosmetic.
    • Some cosmetics are excluded from ownership reporting.

🔧 Changes

• The previously deprecated level, evolution, nextEvolutionLevel and nextLevelProgress fields in CrownLevel have been removed.
• The previously deprecated gems field in Currency has been removed.

Full Changelog: v24.12.04...v24.12.17

v24.12.17: Fishing, cosmetics and MCC+

What's Changed

✨ Features

• Cosmetics and ownership state in #11
• Fishing-related additions in #13
• Added MCC+ subscription status as mccPlusStatus in Player
• Added equipped cosmetics as equippedCosmetics in Collections
• Added anglrTokens to Currency

🔧 Changes

• The gems field in Currency has been deprecated for removal. It will now only return 0
• The deprecated value field in Statistics has been removed following its deprecation

Full Changelog: v24.12.04...v24.12.17

v24.12.04: Angler trophies and evolution index

What's Changed

✨ Features

• Added a new Trophy type, ANGLER trophies!
• Added an evolution index to CrownLevel.

Full Changelog: v24.05.06...v24.12.04