---
id: bcsfe
version: "3.6.0"
license: GPL-3.0-or-later
license_treatment: copyleft
maintenance: active
---

# bcsfe — A save file editor for The Battle Cats

License: copyleft · Maintenance: active · Downloads: 92.5K/mo

## What it is and what it does

BCSFE is a command-line tool that lets you read and modify saved game data for The Battle Cats. It works by extracting save files from the game, decoding and patching the internal data structures (currency, units, progression), and re-encoding them back into a format the game recognizes. The tool uses pyjwt, requests, pyyaml, and argparse to handle cryptographic operations, configuration, and command-line interaction.

You run it as a standalone CLI application or Python module on Windows, macOS, Linux, or Android (via Termux). It supports both graphical file selection (where tk is available) and manual path entry. The editor is designed for end users who want to modify their own game saves; the license explicitly requires that any paid service using this tool must disclose its free availability to customers before payment.

Use it for:

- Restore or modify your own Battle Cats save file after losing progress or switching devices
- Edit in-game currency, unit levels, or other progression metrics for personal testing or experimentation
- Transfer save data between devices or game accounts by editing the save file directly
- Develop derivative tools or bots that modify Battle Cats saves, provided they remain open source

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A command-line save file editor for The Battle Cats game that reads, modifies, and writes back game save data using cryptographic operations.

Yes, if you own The Battle Cats and want to edit your own save file. Low install friction, active maintenance, no known vulnerabilities, and a clear copyleft license. The GPL-3.0-or-later requirement is straightforward for personal use; only matters if you build a commercial service on top of it.

## Install

pip install bcsfe
uv add bcsfe
poetry add bcsfe

## Installing bcsfe

Before you install: Low install friction with a pure Python wheel and four common runtime dependencies. Actively maintained with a recent release.

License in practice: GPL-3.0-or-later copyleft license requires that any derivative works or services built on top of this editor must also be open source and GPL-compatible.

Quickstart:

pip install bcsfe
bcsfe

Requires Python 3.9 or later. On Linux, may require system package tk or python-tk for graphical file dialogs; manual path entry works without it.

Verify before relying:

- Whether the editor handles all current Battle Cats save formats and game versions
- Performance characteristics when working with large or corrupted save files
- Whether pyjwt is used for save authentication or encryption operations

## Package facts

- License: GPL-3.0-or-later (copyleft)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 92.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

battle cats save editor, game save file modifier, battle cats account editor, save data hacking tool, game progress editor cli, game-modding, save-editor, cli-tool

[View on SkillFed](https://skillfed.io/packages/bcsfe) · [View on PyPI](https://pypi.org/project/bcsfe/)