Skip to content

wowsinfo/wowsunpack

 
 

Repository files navigation

WoWsUnpack

License

Based on EdibleBug/WoWS-GameParams, this fork uses wowsunpack.exe to extract GameParams.data before unpacking to GameParams.json.

wowsunpack.exe is provided by WARGAMING.NET.

中文版本

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

Legal Notice and License

I acknowledge and agree to the rights and Terms of Use (ToS) provided by Wargaming.net (WG). 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.

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 referenced when refactoring code.