Jump to content

Use TBCTK as a replacement to BCGM Python

From Battle Cats Game Modding Wiki
Revision as of 10:43, 19 September 2025 by Fieryhenry (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

If you don't want to bother rewriting all of your custom content as TBCTK modifications.

Creating a mod

Run the following command to create a blank mod

tbctk-cli init --id testmod -a username -n "Test Mod" --output cool_dir

This will create a mod in the directory cool_dir in the current working directory.

Adding raw APK files

Raw files are files which are in the APK itself. This can be stuff like raw .pack and .list files, xml files, libraries, etc.

In the mod directory create a file called raw_pkg.toml (or whatever you want), with the following content.

[[dirs]]
path = "./pkg_files/"
recursive = true

Then create a pkg_files directory in the mod folder.

Place all of your modded files in this directory. If you want to place files in a subdirectory in the APK, then just place the files in a folder with the same name.

E.g if you want to replace assets/DataLocal.pack, then add your modified file in mod_folder/pkg_files/assets/DataLocal.pack.

Then in path.toml you should add the following entry:

[[paths]]
mod_type = "pkg_files"
paths = ["./raw_pkg.toml"]

Change raw_pkg.toml if you put the raw files metadata in a different file.

Adding raw game files

Raw game files are files inside the pack files, for example localizable.tsv.

Create a file called game_files.toml