Metadata-Version: 2.1
Name: flammenwerfer
Version: 0.1.9
Summary: Python utility for processing Frostbite engine game files and interacting with the Frosty Editor.
Home-page: https://github.com/BF1CHS/flammenwerfer
Keywords: Frostbite,entertainment,reverse engineering,game development
Author: MaxMixAlex
Author-email: MaxMixAlex@protonmail.com
Requires-Python: >=3.8,<4.0
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Other Audience
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Games/Entertainment
Project-URL: Repository, https://github.com/BF1CHS/flammenwerfer
Description-Content-Type: text/markdown

> [!NOTE]
> This project is migrated from [zyf722/flamethrower](https://github.com/zyf722/flamethrower).
> 
> For versions `v0.1.6` and earlier, please visit [Releases of that repository](https://github.com/zyf722/flamethrower/releases).
>
> **Starting from version `v0.1.7`, this project is renamed `flammenwerfer` to avoid naming conflicts with other projects.**

# flammenwerfer
> 🔥 ***Flammenwerfer*** (*flamethrower* in German), where ❄️ ***Frostbite*** meets the dance of inferno.

`flammenwerfer` is a Python package designed to provide a simple interface for modders to interact with the original Frostbite engine binaries. 

## Installation
This package is managed by [Poetry](https://python-poetry.org/).

**Currently, the package is in its early stages of development and is not yet ready for public use.** However, if you are interested, you can install the package by cloning the repository and running the following command:

```bash
poetry install
```

Then you can use the package in the virtual environment created by Poetry.

## Usage
The package only supports the following features now:

- `flammenwerfer.hash`: Hash functions used by the Frostbite engine. Currently, only FNV series hash functions (`flammenwerfer.hash.fnv`) are supported.
- `flammenwerfer.localization`: Interface for `Histogram` and `LocalizationBinary` files.

Examples of how to use the package are available in the `examples` directory. There is only one example now, which is an interactive toolbox for Chinese localization of Battlefield 1 (with UI in Chinese). More examples are welcomed.

## Contributing
Though the package is still in its early stages of development, [Pull Requests](https://github.com/BF1CHS/flammenwerfer/pulls) are welcome.

You can setup your own copy of the source code with Git and Poetry:

```shell
# Git
git clone https://github.com/BF1CHS/flammenwerfer.git
cd flammenwerfer/

# Poetry
poetry lock
poetry install
poetry shell
```

It is strongly recommended to follow the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) specification when writing commit messages and creating pull requests.

## License
[GPL-3.0](/LICENSE)
