Battle Cats Event Data Downloader

The Battle Cats Event Data Downloader (BCEDD) is a tool made for downloading battle cats event data such as gatya data and sale data.

PyPI

Credits

• The PackPack Discord Bot for the old method of downloading data (aws stuff)

How To Use

Prerequisites

• Python for running and installing the tool

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

Installation

To install / update the tool run the following command:

py -m pip install -U bcedd

If you get an error saying No module named pip then run

py -m ensurepip --upgrade

Run

By default the tool will download sale.tsv, gatya.tsv and item.tsv for en and it will ask you where you want to save it:

py -m bcedd

If you want to download files for different versions use -c <version1> <version2> etc. Supported versions are en, jp, kr, tw.

py -m bcedd -c jp kr

This will download jp and kr data instead

If you only want to download specific files then use -f <file1> <file2> etc. Supported files are sale.tsv, gatya.tsv, item.tsv.

py -m bcedd -f gatya.tsv item.tsv

This will download files gatya.tsv and item.tsv but not sale.tsv

If you don't want a file save dialog then use -o <output_folder> to save the files to a specific folder.

py -m bcedd -o "Event Data"

This will save all 3 en files to a folder called "Event Data" in the current working directory (use the cd command to change that)

If you want to use the old method of downloading data then use --old

py -m bcedd --old

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 git repo directly.

1. Download Git
2. Run the following commands: (You may have to replace py with python or python3)

git clone https://codeberg.org/fieryhenry/bcedd.git
py -m pip install -e bcedd/
py -m bcedd

If you want to use the tool again all you need to do is run the py -m bcedd command

Then if you want the latest changes you only need to run git pull in the downloaded bcedd folder. (use cd to change the folder)