Battle Cats Game Modding Tool

New python version here: https://github.com/fieryhenry/BCGM-Python

A game modding tool for the game The Battle Cats
Most features should work across all game versions (least likely is libnative patch)

I have a discord server: https://discord.gg/DvmMgvn5ZB, it's the best way report bugs and you can leave your suggestions for new features to be implemented in the tool

If you want to support my work and keep me motivated to continue to work on this project then maybe consider gifting me some ko-fi here: https://ko-fi.com/fieryhenry

Thanks To

EasyMoneko for the original keys for decrypting/encrypting: https://www.reddit.com/r/battlecats/comments/41e4l1/is_there_anyone_able_to_access_bc_files_your_help/)
Battle Cats Ultimate for what some of the numbers mean in various csvs.BCU · GitHub
This resource for unit csvs: https://pastebin.com/JrCTPnUV)
Vi on discord for enemy csvs

Features

Decrypt .pack and .list files found in the apk and /data/data/jp.co.ponos..../files.
Encrypt a folder of files and pack it into encrypted .pack and .list files

Modify the libnative-lib.so file found in the:
APK
/data/data/jp.co.ponos..../files
/data/app/jp.co.ponos..../
To remove the check for the md5 sum for the .pack and .list files - avoids Data Read Error h01

Modify the stats of cat units
Modify stage data
Modify enemy stats

How To Edit Game Data

Unpack the apk file for the game using apktool/APK Easy Tool
Get the .pack and .list files that contain the files you want to edit:
Most stats are in DataLocal
Most text is in resLocal
Sprites are in various Server files
Run the tool - Download exe from releases (You may need to install the .net 6 runtime: https://dotnet.microsoft.com/en-us/download/dotnet/6.0)
Select option to decrypt .pack
Select .pack files that you want
Once completed the files will be in /game_files
You can manually edit the data, or use the option in the tool that you want
Once edited, open the tool and select the encrypt option
Select the folder of the game files
Once complete the encrypted files will be /encrypted_files
Get your libnative-lib.so file for your system architecture. You can find it in the apk, /data/app/jp.co.ponos.battlecats.../{architecture}/, or in /data/data/jp.co.ponos.battlecats.../
Run the tool and select the option to patch the libnative-lib.so file
Enter the system architecture the file is from
Once done:
1. Replace the file in the apk for permanent change.(apk must be signed - APK Easy Tool - for most devices to install the apk) (must re-install app or replace apk in /data/app/jp.co.ponos.battlecats.../base.apk if you choose to do this method).
2. Replace the file in /data/app to work without re-installing for your device.
3. replace the file in /data/data only if you modifed server files for your device.
  I recommend doing 1 and 2 for local files. And all 3 for server files.
Open the game and see if it works
If you modifed server files, you will need to find the associated download.tsv file for your .pack and .list files in the apk in /assets/{language}.
Open the file in notepad, you will see the name of the file, then a tab, then the file size in bytes, then a tab, then the md5 hash of that file.
You need to modify that md5 hash so that the game doesn't re-download the server data
Go to here: https://emn178.github.io/online-tools/md5_checksum.html and drag and drop the file in
Copy the hash and replace the one in the tsv with that one.
Replace the apk in /data/app/jp.co.ponos.battlecats.../base.apk with your apk, use apktool/APK Easy Tool to sign the app and pack it into an apk again.
Open the game and see if it works.
If it re-downloads game data maybe also try to replace the file size in bytes for the .pack file. Right click->properties->Size (not Size on disk)
In the future I might find a way to edit the libnative-lib.so file to skip that check also.

fieryhenry/Battle-Cats-Game-Modder

Battle Cats Game Modding Tool

New python version here: https://github.com/fieryhenry/BCGM-Python

Thanks To

Features

How To Edit Game Data