A battle cats tool for modifying, encrypting, and decrypting game files
Project description
Battle Cats Game Modding Tool
A python game modding tool for the mobile game The Battle Cats that can decrypt, encrypt, and modify some game files.
Note: I am no longer actively working on this tool so there may be bugs. I'm working on a simpler and much more powerful new modding tool that will replace this one when it's eventually finished.
It is a pretty much direct port from my C# game modding tool with a few bug fixes.
Join the discord server if you want to suggest new features, report bugs or get help on how to use the modder. (Discord is the same one as for save editing as I haven't made a modding specific one yet)
PyPi: https://pypi.org/project/battle-cats-game-modder/
If you want to support me then 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. https://github.com/battlecatsultimate
-
This resource for unit csvs: https://pastebin.com/JrCTPnUV
-
Vi on discord for enemy csvs
How to use:
-
Install python (If you haven't already) https://www.python.org/downloads/
-
Enter the command:
py -m pip install -U battle-cats-game-modder
into cmd or another terminal to install the editor. If that doesn't work then usepython
instead ofpy
in the command -
Unpack the apk file for the game using Apktool or APKToolGui.
-
You can then find the .pack and .list files in the assets folder of the extracted APK.
-
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
-
-
Then enter the command:
py -m BCGM_Python
to run the tool. If that doesn't work then usepython
instead ofpy
in the command -
Select option to decrypt .pack files
-
Select .pack files that you want, they will be in
/assets
for local files in the extracted apk, or/data/data/jp.co.ponos.battlecatsen/files
for downloaded server files -
Also decrypt the DownloadLocal pack as you will need it for later
-
Once completed the files will be in a
game_files
folder in the folder you ran the command from -
You can manually edit the data, or use the option in the tool that you want
-
Once edited, you should place any modified files in the DownloadLocal pack folder
-
Open the tool again and select the
encrypt
option -
Select the DownloadLocal folder
-
Once complete the encrypted .pack and .list files will be in an
encrypted_files
folder in the folder you ran the command from -
If you are asked if you want to patch the libnative file, say no as this featrue is currently broken and you do not need to do it if you placed your files in DownloadLocal
-
Then you need to place the encrypted .pack and .list files back into the assets folder of the apk
-
You then need to pack the apk using apktool or apktoolgui
-
You then need to sign the apk using apktool or apktoolgui
-
You then need to install the apk, you may have to uninstall the game first before installing the modified apk for the first time
-
Open the game and see if it works
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for battle-cats-game-modder-1.0.5.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 840f78a17a08fa24763c4f70de48fcd5ba37a05de3928a21b505e3aeffe5bc30 |
|
MD5 | ea045fe4cb9d1e6d8876bd3766758faa |
|
BLAKE2b-256 | 09d7b90dc85250989685fb5f8c9a545c86ddf62e9e373a0f9c4b7eb77e9bf576 |
Hashes for battle_cats_game_modder-1.0.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f5ec77c88f8e9dfd29e2884f9cb146f24a4e3c1bbdaaca115b1e2f4cc2cdde8c |
|
MD5 | e5850b77d5642041fbea96624cb9a9db |
|
BLAKE2b-256 | 07857265cec3f482bc6515b780c84453c91d07f525a2b5889e1dfc2ebfd5466f |