This information is a compilation of arcane tradecraft that will only interest third party developers using the Splinterlands API. If you are not a developer, the below (while potentially insightful if you are technically minded) will likely not be of much interest and you should probably stop reading now.
| Format | Cards Allowed |
|---|---|
| Wild | All |
| Modern | Chaos Legion, Dice, Untamed, Reward & Promo cards with an Untamed or Chaos Legion style frame are all considered Modern cards. |
Technical definition: any card that has an edition in [4,5,7], OR tier in [3,4,7] is considered to be Modern.
For all APIs that return player data (including but not limited to those mentioned below), new fields have been added that contain Modern stats. These new fields will be in addition to the original stats (which are now interpreted as being for the Wild format). All such fields will be prefixed with modern_. Data not explicitly prefixed with modern_ should be assumed to be Wild data.
For all APIs that return battle data, there will be a new field format included in the response data. This field will be set to modern if it is defined. If it is undefined, the battle should be taken to be a Wild battle.
Added the following fields:
modern_num_editions functions analogously to num_editions but for the Modern format. The current value is 5.battles.modern configuration that defines exactly what a Modern card is:leaderboard_prizes re-organized into wild and modern sub-categoriesleagues re-organized into wild and modern sub-categoriesRemoved the following fields:
new_rewards_season is no longer needed as support for pre-Ranked Rewards V2 functionality has been droppedquests no longer needed as support for old-style quests has been dropped (the new daily_quests field has replaced this)Example: https://qa.splinterlands.com/settings
This API is no longer supported and any attempt to use it will return an error message.
The league field has been removed from response data.
Example: https://qa.splinterlands.com/players/quests?username=farpetrad
Response data now includes additional information about Modern stats. Data not explicitly prefixed with modern_ should be assumed to be Wild data. current_modern_season_player and previous_modern_season_player fields have been added that function equivalently to their Wild counterparts. Note that these optional fields will not be defined if the player has not played any Modern battles in the corresponding seasons.
Example: https://qa.splinterlands.com/players/refresh_season_data?token=XXXXXXXXXX&username=myname
Response data now includes additional information about Modern stats. Data not explicitly prefixed with modern_ should be assumed to be Wild data.
Example: https://qa.splinterlands.com/players/refresh?token=XXXXXXXXXX&username=myname
Added an optional format query parameter, which if used must be set to either modern or all. This parameter only makes a difference if used in combination with the seasondetails parameter. It determines whether the returned season_details object is for Wild or Modern. If format is not present, then the API will default to giving season_details results only for the Wild format.
A new field player_uuid has also been added, containing the unique UUID for the queried player.
Valid values for seasondetails (this must be a string value):
Valid values for format (this must be a string value):
season_details.modern and season_details.wild in the response data)Example: https://qa.splinterlands.com/players/details?name=brybro27&season_details=true&format=modern
Added an optional format query parameter. The format and seasondetails parameters now obey the same rules & support the same values as explained above for the players/details API. This API functions the same way, except players/details_by_id allows lookup by the unique UUID rather than player name.
New fields modern_inflation and modern_reward_pool have been added to the response data.
Example: https://qa.splinterlands.com/players/dec
Added an optional format query parameter, which if used must be set to modern. If format is not present, then the API will default to giving results only for the Wild format.
Added an optional format query parameter, which if used must be set to modern. If format is not present, then the API will default to giving results only for the Wild format.
Example: https://qa.splinterlands.com/players/leaderboard?season=89&leaderboard=2&format=modern
Added an optional format query parameter, which if used must be set to modern. If format is not present, then the API will default to giving results only for the Wild format.
Example: https://qa.splinterlands.com/players/recent_teams?player=brybro27&format=modern
Added an optional format query parameter, which can be set to modern or wild. If format is not present, then the API will default to giving results for both formats mixed together.
Example: https://qa.splinterlands.com/battle/history?player=brybro27&format=modern
Added an optional format query parameter, which if used must be set to modern. If format is not present, then the API will default to giving results only for the Wild format.
Example: https://qa.splinterlands.com/battle/history2?player=$top&leaderboard=2&format=modern
sm_advance_league - added an optional format custom JSON field, which if used must be set to modern. If format is not present, then the transaction will default to Wild format processing.
find_match - match_type parameter can optionally be set to Modern Ranked or Wild Ranked. Pre-Modern & Wild usage is to set it to Ranked, which will be kept for backward compatibility and interpreted to mean Wild Ranked.
A new field epoch has been added to the allowed_cards tournament settings data. If present, epoch will be either modern or wild. For older tournaments, epoch may not be defined. If epoch is not defined, the tournament will be treated as a Wild tournament.
Modern tournaments only allow Modern cards to be used. In such tournaments, all other settings such as edition restrictions, gold foil rules, etc still apply as usual.
Also note that in Modern tournaments, only Modern cards count towards Collection Power entry requirements, and entry fee discounts are based on the player’s Modern league. For Wild tournaments, entry fee discounts are based on the player’s Wild league.
Example: https://qa.splinterlands.com/tournaments/find?id=18d8886db38128a011290d76d76261e48f869b1c
The API examples given above are only that, examples of how such queries should be formed. They are not guaranteed to actually return data, as the state of the QA environment constantly changes.
Also, before testing your app against QA, you should confirm in the Splinterlands Discord that Modern & Wild has actually been deployed there. At the time of writing, it has not. Expect that it will be soon, and a notice will be given in the developers-3rd-party channel.
Website | Blog | Discord | Telegram | Shop
NOTE: All rewards from this post will be burned.