Documentation of all Battle Breakers related API / MCP calls

What is Battle Breakers?

Battle Breakers was a cartoon-themed Hero collector, Turn-Based, and Action RPG game developed by Chair Entertainment and Epic Games. Released in beta in 2016 and launched in 2019, the game was since shut down at the end of 2022.

What is this repository?

This repository is a collection of all the API calls made by the game, and the data they return. This is a work in progress, and will be updated as more information is found. If you have any information to add, please feel free to open a pull request.

---

If you reference any of this information in your own work, please credit / link back to this repository.

---

Where are the docs?

The docs are located in the docs folder. The docs are written in Markdown, organised by the API endpoint they reference, and are generated by this script I wrote. Some requests/responses are altered to remove sensitive information.

What's missing?

MCP Operations

These are MCP Operations that did not have their behaviour fully documented from the official server, however almost all are functional on the server emulator.

• AddFriend
• ClaimGiftPoints
  • Unfortunately ClaimGiftPoints, along with the notification data required for receiving gift points was lost. If you have or can find any Battle Breakers sessions, packet captures, etc; and/or can assist with SDK dumping a 32-bit UE 4.25 title, please contact me on Discord at dippy is not here.
• DeleteFriend
• MarkHeroSeen
• MarkItemSeen
• RedeemToken
• RequestPreregistrationReward
• SellGear
• SellMultipleGear
• SellTreasure
• SetRepHero
• SuggestFriends
• UpdateAccountHeadlessStatus
• VerifyRealMoneyPurchase

API Endpoints

These are additional API endpoints under the WEX service that were not documented.

• wex/api/game/v2/friends/accountid/search?name=
  • This endpoint was used for the legacy friends system on pre-1.80 clients, and was documented by Lele here
• wex/api/game/v2/item_ratings
  • Specifically the POST for when casting votes on characters
• wex/api/game/v2/motd
• wex/api/feedback/log-upload/
• wex/api/push/accountid/register (notifications)
• wex/api/storeaccess/v1/redeem_access/accountid
• wex/api/storeaccess/v1/request_access/accountid
• wex/api/accesscontrol/status

These are additional API endpoints on other services that were not documented.

• https://www.epicgames.com/battlebreakers/motd?rvn=-1
• https://bbcontent-website-prod07.ol.epicgames.com/content/api/pages/`key`
  • This was a clone of Fortnite's content API, however it went unused by game clients. The key for this service was never found, and on ~2/06/2024, the service was removed.
• account/api/public/account/accountid/externalAuths (linking accounts)

Manifests & Chunks

These manifests and chunks were hosted on an S3 Bucket, which was later put behind cloudfront, and then additionally put behind a CDN when the system switched to using Build Manifests. The S3 bucket was deleted on ~2/06/2024, rendering all of these manifests and chunks unavailable officially.

• ChunkV3 HTTPChunkInstaller Manifests & Chunks
  • Used by old builds (Used by 1.0.x - 1.5.x)
  • Platforms: WindowsNoEditor, Android_ASTC, Android_ATC, Android_DXT, Android_ETC1, Android_ETC2, Android_PVRTC, IOS
  • As the master manifests were stored under wex, they are no longer available (however I re-created them manually, and they can be accessed here)
  • As of ~2/06/2024, all Battle Breakers S3 buckets have been deleted, and ChunkV3 manifests + chunks are no longer available anywhere officially.
• Build Manifests
  • Used by new mobile builds (Used by 1.6.x - 1.88.x)
  • Platforms: Windows, Android_ASTC, Android_ATC, Android_DXT, Android_ETC1, Android_ETC2, Android_PVRTC, IOS
  • As of ~2/06/2024, all Battle Breakers S3 buckets have been deleted, and Build Manifest manifests + PAKs are no longer available anywhere officially.

Version Information

Version & Changelist	Release Date	Archived Builds	Archived PAKs	Engine Version
1.88.244-r17036752	2021		✅	4.25.0-17035652
1.88.165-r14606516	2020		✅	4.25.0
1.88.0	2020		❌	4.25.0
1.87.143-r14443610	2020		❌	4.25.0
1.86.83-r14347717	2020		✅	4.25.0
1.85.462-r14276011	10/09/20		✅	4.25.0
1.84.752-r13922354	29/07/20		✅	4.25.0
1.84.635	25/06/20		❌	4.25.0
1.84.579-r13741918	6/07/20		✅	4.25.0
1.83.304-r12154759	17/03/20		✅	4.23.0
1.83.252-r11972457	10/03/20		✅	4.23.0
1.82.353-r11264911	2020		✅	4.23.0
1.82.328-r11197089	4/02/20		✅	4.23.0
1.81.583-r11039983	21/01/20		✅	4.23.0
1.81.408-r10698544	16/12/19		✅	4.23.0
1.80.1806-r10407794	29/11/19		✅	4.23.0
1.80.1779-r10330063	27/11/19		✅	4.23.0
1.80.1758-r10303436	20/11/19		✅	4.23.0
1.80.1696-r10121395	13/11/19		✅	4.23.0
1.80.1675-r10091636	11/11/19		✅	4.23.0
1.80.1557-r9915551	7/11/19		✅	4.23.0
1.71.186-r4504633	29/10/19		✅	4.20.0
1.7.1013-r4371600	18/09/18		✅	4.20.0
1.6.442-r4076582	21/05/18		✅	4.20.0
1.5.189-r3891207	20/02/18		✅	4.19.0
1.5.145-r3842684	22/01/18		✅	4.19.0
1.4.164-r3719898	30/10/17		✅	4.18.0
1.4.103-r3693860	30/10/17		✅	4.18.0
1.3.3	25/08/17		❌	4.17.0
1.3.130-r3604802	14/08/17		✅	4.17.0
3582133	2017		✅	4.17.0
3577771	2017		✅	4.17.0
3571999	2017		✅	4.17.0
1.3.0	7/08/17		❌	4.17.0
1.2.227-r3514827	10/07/17		✅	4.16.0
3485685	2017		✅	4.16.0
1.1-r3437464	2017		✅	4.16.0
3379392	2017		✅	4.16.0
3373325	2017		✅	4.16.0
3370045	2017		✅	4.16.0
3369955	2017		✅	4.16.0
3359023	2017		✅	4.16.0
3337069	2017		✅	4.16.0
1.0-r3302067	10/04/17		✅	4.16.0
3296092	2017		✅	4.16.0
1.0.5	5/04/17		❌
1.0.4	30/03/17		❌
1.0.3	14/03/17		❌
1.0.2	15/02/17		❌
1.0.1	17/01/17		❌
1.0.0	17/01/17		❌
1.0-beta	12/12/16		❌

If you discover any other builds, please let me know!

How do I contribute?

If you have any information to add, please feel free to open a pull request. If you have any questions/requests, please feel free to open an issue, or contact me on Discord at dippy is not here#1332.