bsml

BSML stands for Brawl Stars Mod Loader. It is an Android application that lets players apply visual and data modifications to the mobile game Brawl Stars without modifying the game's installation files and without needing root access on the device. The README is written in Russian with a note that an English version exists in a separate file.

The central technical challenge the project solves is that the game verifies its own files before connecting to the server. If those files have been changed, the game normally refuses to connect. BSML works around this by acting as a local intermediary between the game and the server. It sets up a local VPN tunnel on the device, which lets it intercept the network traffic the game sends to Supercell's servers. When the game sends its initial connection message containing a fingerprint of its current files, BSML replaces that fingerprint with a modified version. The server then responds by telling the game to download updated files, and BSML intercepts that response too, redirecting the download address to a small web server running on the device itself. When the game then requests its game files, BSML's local server returns the modded versions for any files that have been changed and returns the original files for everything else.

Mods are distributed as archive files with a custom extension. BSML reads the mod files, merges any data table changes precisely into the originals, compresses the result in the exact format the game expects, and serves them to the game on demand. When the user turns off mods, BSML sends the game's original file fingerprint, lets the game download and restore all original files from the local cache, and then shuts down the VPN to reduce battery use.

The tool runs on Android 7.0 and above. The interface is built with Jetpack Compose, a modern Android UI toolkit. The project uses Kotlin as its primary language. All file handling, including the compressed data table format the game uses internally, is done locally on the device with no external service required.

The README notes this is intended for Brawl Stars and other compatible Supercell games. No details about what specific visual or gameplay changes a given mod would make are described in the README itself, as that depends on the mod file being loaded.