| Name | bcdd JSON |
| Version |
1.0.2
JSON |
| download |
| home_page | https://codeberg.org/fieryhenry/bcdd |
| Summary | A tool for decrypting and encrypting battle cats .dat files |
| upload_time | 2025-08-16 14:04:40 |
| maintainer | None |
| docs_url | None |
| author | fieryhenry |
| requires_python | >=3.9 |
| license | None |
| keywords |
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Battle Cats Dat Decryptor
The Battle Cats Dat Decryptor (BCDD) is a tool made for decrypting, encrypting
and hashing battle cats event data that is stored in the /files directory of
the game data. atm there is limited functionality but in the future I plan to be
able to modify the event data directly in the tool.
PyPI: <https://pypi.org/project/bcdd/>
Example of what you can do by modifying the data: <https://youtu.be/BXmZT66KS_o?si=TGmJyt3bO8a4XylC>
## How To Use
### Prerequisites
- [Python](https://www.python.org/downloads/) for running and installing the tool
### Installation
Run the following commands in command prompt or another terminal to install the
tool - If you are not using windows you will need to use `python` or `python3`
instead of `py`:
```bash
py -m pip install -U bcdd
```
If you get an error saying `No module named pip` then run
```bash
py -m ensurepip --upgrade
```
### Run
```bash
py -m bcdd
```
## Locating the .dat files
You will need a rooted android device to access the data stored in /data/data.
Then you will need to download and install a root explorer such as [root explorer](https://rootexplorer.co/download/RootExplorer.apk).
Then in root explorer in the `root` tab navigate to
`/data/data/jp.co.ponos.battlecats{gv}/files` depending on what game version
you are using:
- en: `jp.co.ponos.battlecatsen`
- kr: `jp.co.ponos.battlecatskr`
- tw: `jp.co.ponos.battlecatstw`
- jp: `jp.co.ponos.battlecats`
You need to have run the game and entered the cat base at least once to have the
event data available.
The .dat file names are long and correspond to the following data:
- Sale data (also has event stage stuff, idk why it's called sale.tsv):
`002a4b18244f32d7833fd81bc833b97f.dat` : `event_0`
- Gatya data: `09b1058188348630d98a08e0f731f6bd.dat` : `event_1`
- Daily reward data: `408f66def075926baea9466e70504a3b.dat` : `event_2`
- Ad control data: `523af537946b79c4f8369ed39ba78605.dat` : `ad`
If you're interested the file name is the md5 hash of `event_0`, `ad`,
`event_2`, etc
Once you have located the files you need to get access to them on your pc, so
copy them to a place that you can access without root (e.g Documents) and
connect your device to your pc, or just send them to yourself.
### Decrypting Data
Now that you have the files you then need to run the tool (see above in the
`Run` section).
Then select what game version you are using.
Then select the option to `Decrypt a .dat file`.
It will then ask you to select a .dat file to decrypt and then it will ask you
where you want to save the decrypted file.
### Encrypting Data
Once you have finished editing the decrypted .dat data you then need to select
the option to `Encrypt a .dat file`.
It will then ask you to select a .dat file to decrypt and then it will ask you
you where you want to save the encrypted file.
After encrypting you then need to get the file back onto your device and then
replace the original .dat file in the game folder with the new modified one.
Then you can open the game.
### Interpreting event data
In the future I might add support for this directly in the tool but for now
you'll need to use a text editor such as notepad++, or notepad if you want. You
can then open the decrypted data in the text editor and modify what you want.
You can read [this
guide](https://www.reddit.com/r/battlecats/wiki/event_data/decoding_guide/) to
help you figure out what sutff means.
## Install From Source
If you want the latest features and don't want to wait for a release then you
can install the tool from the Codeberg directly.
1. Download [Git](https://git-scm.com/downloads)
2. Run the following commands: (You may have to replace `py` with `python` or `python3`)
```bash
git clone https://codeberg.org/fieryhenry/bcdd.git
py -m pip install -e bcdd/
py -m bcdd
```
If you want to use the tool again all you need to do is run the `py -m bcdd` command
Then if you want the latest changes you only need to run `git pull` in the
downloaded `bcdd` folder. (use `cd` to change the folder)
Raw data
{
"_id": null,
"home_page": "https://codeberg.org/fieryhenry/bcdd",
"name": "bcdd",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": "fieryhenry",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/82/39/fd2b4dfd0b81526f523e0ebd0ed5be53a5dd38bbeac32b07149d6ff4b810/bcdd-1.0.2.tar.gz",
"platform": null,
"description": "# Battle Cats Dat Decryptor\n\nThe Battle Cats Dat Decryptor (BCDD) is a tool made for decrypting, encrypting\nand hashing battle cats event data that is stored in the /files directory of\nthe game data. atm there is limited functionality but in the future I plan to be\nable to modify the event data directly in the tool.\n\nPyPI: <https://pypi.org/project/bcdd/>\n\nExample of what you can do by modifying the data: <https://youtu.be/BXmZT66KS_o?si=TGmJyt3bO8a4XylC>\n\n## How To Use\n\n### Prerequisites\n\n- [Python](https://www.python.org/downloads/) for running and installing the tool\n\n### Installation\n\nRun the following commands in command prompt or another terminal to install the\ntool - If you are not using windows you will need to use `python` or `python3`\ninstead of `py`:\n\n```bash\npy -m pip install -U bcdd\n```\n\nIf you get an error saying `No module named pip` then run\n\n```bash\npy -m ensurepip --upgrade\n```\n\n### Run\n\n```bash\npy -m bcdd\n```\n\n## Locating the .dat files\n\nYou will need a rooted android device to access the data stored in /data/data.\nThen you will need to download and install a root explorer such as [root explorer](https://rootexplorer.co/download/RootExplorer.apk).\nThen in root explorer in the `root` tab navigate to\n`/data/data/jp.co.ponos.battlecats{gv}/files` depending on what game version\nyou are using:\n\n- en: `jp.co.ponos.battlecatsen`\n- kr: `jp.co.ponos.battlecatskr`\n- tw: `jp.co.ponos.battlecatstw`\n- jp: `jp.co.ponos.battlecats`\n\nYou need to have run the game and entered the cat base at least once to have the\nevent data available.\nThe .dat file names are long and correspond to the following data:\n\n- Sale data (also has event stage stuff, idk why it's called sale.tsv):\n `002a4b18244f32d7833fd81bc833b97f.dat` : `event_0`\n- Gatya data: `09b1058188348630d98a08e0f731f6bd.dat` : `event_1`\n- Daily reward data: `408f66def075926baea9466e70504a3b.dat` : `event_2`\n- Ad control data: `523af537946b79c4f8369ed39ba78605.dat` : `ad`\n\nIf you're interested the file name is the md5 hash of `event_0`, `ad`,\n`event_2`, etc\n\nOnce you have located the files you need to get access to them on your pc, so\ncopy them to a place that you can access without root (e.g Documents) and\nconnect your device to your pc, or just send them to yourself.\n\n### Decrypting Data\n\nNow that you have the files you then need to run the tool (see above in the\n`Run` section).\nThen select what game version you are using.\nThen select the option to `Decrypt a .dat file`.\nIt will then ask you to select a .dat file to decrypt and then it will ask you\nwhere you want to save the decrypted file.\n\n### Encrypting Data\n\nOnce you have finished editing the decrypted .dat data you then need to select\nthe option to `Encrypt a .dat file`.\nIt will then ask you to select a .dat file to decrypt and then it will ask you\nyou where you want to save the encrypted file.\n\nAfter encrypting you then need to get the file back onto your device and then\nreplace the original .dat file in the game folder with the new modified one.\nThen you can open the game.\n\n### Interpreting event data\n\nIn the future I might add support for this directly in the tool but for now\nyou'll need to use a text editor such as notepad++, or notepad if you want. You\ncan then open the decrypted data in the text editor and modify what you want.\nYou can read [this\nguide](https://www.reddit.com/r/battlecats/wiki/event_data/decoding_guide/) to\nhelp you figure out what sutff means.\n\n## Install From Source\n\nIf you want the latest features and don't want to wait for a release then you\ncan install the tool from the Codeberg directly.\n\n1. Download [Git](https://git-scm.com/downloads)\n2. Run the following commands: (You may have to replace `py` with `python` or `python3`)\n\n```bash\ngit clone https://codeberg.org/fieryhenry/bcdd.git\npy -m pip install -e bcdd/\npy -m bcdd\n```\n\nIf you want to use the tool again all you need to do is run the `py -m bcdd` command\n\nThen if you want the latest changes you only need to run `git pull` in the\ndownloaded `bcdd` folder. (use `cd` to change the folder)\n",
"bugtrack_url": null,
"license": null,
"summary": "A tool for decrypting and encrypting battle cats .dat files",
"version": "1.0.2",
"project_urls": {
"Homepage": "https://codeberg.org/fieryhenry/bcdd"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "4a15a090f6211a5e30c9034ae368dca1f481892d1690b23217c1854b6815a5d2",
"md5": "d365e1b39535c9bd722d9657751621bc",
"sha256": "7aa24d82cdae6c1d0b77258e82974b127c3658eb61264ceaaf88e7d535f498bb"
},
"downloads": -1,
"filename": "bcdd-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d365e1b39535c9bd722d9657751621bc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 18285,
"upload_time": "2025-08-16T14:04:38",
"upload_time_iso_8601": "2025-08-16T14:04:38.881682Z",
"url": "https://files.pythonhosted.org/packages/4a/15/a090f6211a5e30c9034ae368dca1f481892d1690b23217c1854b6815a5d2/bcdd-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "8239fd2b4dfd0b81526f523e0ebd0ed5be53a5dd38bbeac32b07149d6ff4b810",
"md5": "64799aecbaa4fa43b59a169add9354e8",
"sha256": "85f138b7c9dbcc81bb093ac28e590981d7d9816c4c6bd6b949c651e34c24abe0"
},
"downloads": -1,
"filename": "bcdd-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "64799aecbaa4fa43b59a169add9354e8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 17706,
"upload_time": "2025-08-16T14:04:40",
"upload_time_iso_8601": "2025-08-16T14:04:40.102629Z",
"url": "https://files.pythonhosted.org/packages/82/39/fd2b4dfd0b81526f523e0ebd0ed5be53a5dd38bbeac32b07149d6ff4b810/bcdd-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-16 14:04:40",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": true,
"codeberg_user": "fieryhenry",
"codeberg_project": "bcdd",
"lcname": "bcdd"
}
