Metadata-Version: 2.1
Name: wowsunpack
Version: 0.1.7
Summary: Unpack World of Warships game params to JSON
Author-email: Yiheng Quan <development.henryquan@gmail.com>
Project-URL: Homepage, https://github.com/wowsinfo/wows_unpack
Keywords: wows,wws,unpack,params
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU Affero General Public License v3
Classifier: Operating System :: Microsoft :: Windows
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# WoWsUnpack
[![License](https://img.shields.io/github/license/WoWs-Info/wows_unpack)](./LICENSE)

Based on [EdibleBug/WoWS-GameParams](https://github.com/EdibleBug/WoWS-GameParams), this fork uses `wowsunpack.exe` to extract `GameParams.data` before unpacking to `GameParams.json`.

`wowsunpack.exe` is provided by [WARGAMING.NET](https://wargaming.com/).

[中文版本](./使用说明.md)

## Optional features
- Decode game languages
- Unpack game maps
- Unpack game icons
- Pack game assets

## Setup
- Use Python 3 and `python3 -m venv .env` to create a virtual environment
- Install dependencies with `pip install -r requirements.txt`
- Run `python3 run.py`
- Paste the game path into `game.path`
- Run `python3 run.py` again to unpack

## Use without Python
- Download the latest binary
- Double click on `unpack.exe`
- Paste the game path into `game.path`
- Double click on `unpack.exe` again to unpack

Windows may scan `unpack.exe` only for the first time. The binary is built with `pyinstaller`. `WoWsUnpack` is not responsible for anything if `pyinstaller` injects any malicious code while generating the binary. Please use the binary at your own risk.

## Arguments
- `--lang`: Decode game languages
- `--maps`: Unpack game maps
- `--icons`: Unpack all game icons
- `--assets`: Pack game assets into folders

Any other arguments are not valid. The program will exit with error code 1. Call the program like `./unpack.exe --lang` from the terminal. Double clicking will not pass in any arguments.

## Building
- Run `build_exe.py` to build the binary, and it will be placed in `dist/` ready to go
- Run `python3 -m build` to build the package, and it will also be placed in `dist/`
  - Install it locally with `pip install wowsunpack --find-links=dist`

## Publishing
- Check with `twine check dist/*`
- Upload to TestPyPI before publishing it `twine upload -r testpypi dist/*`
  - Install with `pip install wowsunpack -i https://testpypi.python.org/pypi`
- Publish it with `twine upload dist/*`

***

# World of Warships GameParams to JSON
[![License](https://img.shields.io/github/license/EdibleBug/WoWS-GameParams)](https://github.com/EdibleBug/WoWS-GameParams/blob/master/LICENSE)

## Legal Notice and License
I acknowledge and agree to the rights and Terms of Use (ToS) provided by [Wargaming.net (WG)](https://wargaming.com/). Any users wishing to use the code or WoWSFT must also acknowledge and agree to the rights and ToS underlined by WG. I am not held responsible for any issues or problems that may occur related to using WoWSFT and/or provided codes.

Any codes and materials created by me are under [MIT License](https://github.com/EdibleBug/WoWS-GameParams/blob/master/LICENSE).

## Instruction
1. Use Python 3.
2. Legacy folder is outdated, do not use.
3. Extract GameParams.data into same folder.
    * OneFileToRuleThemAll.py
        * Extracts into a huge JSON file with everything included. This file is not intended for reading.
    * OneFileToSplitThemAll.py
        * Splits into many JSON files, with file name as key and value as content.
        * Example folder/file structure
          ```
          __ root
            |__ sub
               |__ 0
                  |__ Ability
                  |  |__ PCY001_CrashCrew.json
                  |  |__ ...
                  |__ Achievement
                  |  |__ PCH001_DoubleKill.json
                  |  |__ ...
                  |__ ...
          ```

Original codes from XeNTax forum, modified a while ago due to incompatibility with data.

[GameParams2Json](https://github.com/imkindaprogrammermyself/GameParams2Json) referenced when refactoring code.
