Jump to content
You need to play a total of 1 battles to post in this section.
MatroseFuchs

[ALL] WOWS Unpack Tool: unpack game client resources

20 comments in this topic

Recommended Posts

Administrator
432 posts
12 battles

Greetings, all!

 

WoWs Unpack Tool (referred below as the program) is used not only to interact with console utility program wowsunpack.exe used to unpack in game resources (referred below as the utility) but also has a list of its own functionalities that can assist our respected modders in their work. WoWs Unpack Tool is compatible with Steam version of the game.

wows_unpack1.png

 

Program installation:

Spoiler
  1. Download the program from link 1 or link 2
  2. Program should be put directly into the root game folder. i.e. C:\Games\World_of_Warships
  3. Notice, that in the files address no other letter symbols that Latin alphabet is allowed

 

Working with the program:

Spoiler
  1. Launch the program. It’ll be automatically checked for available updates. If the utility is not located on the drive, or if there are updates available, the program will offer to install required updates.
    ATTENTION: If the program cannot download the unpacker (Error connecting to the update server), then it will offer to download it through the browser. You can also download the utility yourself at this link or this. In this case, the downloaded utility must be placed next to the program. Please note that the built-in auto-update function of the program may not work for everyone. The cause of this error has not yet been established.
  2. Then you need to download the lists of packed content by the according button “Load content”.
  3. After downloading the content tree, you can select the necessary files and folders and add them to the list of tasks of the unpack utility. Adding can be done by pressing the ">>" key or dragging an item from the content tree to the unpacking list.
  4. You can add additional file locations by «+» button or by pasting the file address by Ctrl+V.
  5. After you’ve chosen the required file, press “Unpack” and wait for the unpacking process is finished

wows_unpack2.png

 

Program settings and functions:

Spoiler

wows_unpack3.pngwows_unpack4.png

You can choose additional program functions via “Settings” button in the main program window. Below is the description of the option in the list:

  1. Program language – currently available ones are English and Russian. If you need another language added, please DM me.
  2. If chosen, at the program launch it’ll automatically download the list of packed content. It’s not recommended to choose this option at the same time as the option 3.1
  3. If chosen, allows to save the last used list of content for unpacking. When launched next time, the program will use this path automatically.
    1. If chosen, automatically starts unpacking the files in the save location. It’s not recommended to choose this option at the same time as the option 2
  4. If chosen, opens the files folder after the unpacking process is done
  5. If chosen, the program will automatically check for updates after launch. This option can be chosen by “Information” window via according button. Checking for updates will also consider the game client version – to not update the update the app when your game client version is not the same as server unpacking tool (i.e. they are incompatible)
    1. If chosen the program will save the reserve copies of the updates apps.
  6. If chosen, allows to set the custom paths to the files to unpack. By default, the program searches for the files in the root game folder.
  7. This option is useful when within the folder content there are previously unpacked game client files – for example, if we want to know which files of 0.7.12 had been changed in version 0.8.0. Files that stayed the same will be skipped, while new or changed ones will be saved in the folder. The names of such new or changed files will be shown after the unpack – green for new, black for changed. By left click you can open the folder for these files.
    1. After unpacking new or changed file, the previous version of the file will be saved as back file (i.e. reserve copy) prior to the replace into the folder
    2. Set additional custom folder for comparing the unpacked files. The files in this folder are considered to be the newer ones. Option can be set by right-clicking on the “Unpack” button in main program window.

 

Info dialogue window:

Spoiler

Window can be opened by clicking “I” in the main program menu (next to “minimize”) and shows the current version of the program and utility, based on the folder path to the unpacked content. This window also contains the links to checking the new version and to the forum.

wows_unpack5.png

 

 

Key binding:

Spoiler

In program standby mode:

  • Ctrl + S – upload content;
  • Ctrl + U – unpack the selected content;
  • Ctrl + F – open the dialogue for search within the folder tree of selected content;
  • Ctrl + С – copy the content of the unpack window;
  • Ctrl + V – paste the selected content into the unpacking list window;
  • Ctrl + X – close the program;

When unpacking or uploading content:

  • Ctrl + С – cancel the process of unpacking or uploading.

 

Working with wowsunpack.exe utility via console command lines (just in case):

Spoiler

wowsunpack.exe [-h] [-l] [-x] [-o OUTPUT] [-I INCLUDE] [-X EXCLUDE]

INPUT

Optional arguments:

-h, --help            help

-l, --list               show as a list

-x, --extract       unpack using idx at bin\2666186\idx (required parameter, bin and idx are the current build number)

-p ..\..\..\res_packages

                                     path to packed content: .. \ .. \ .. \ res_packages (constant required parameter)

-o OUTPUT, --output OUTPUT

                         Folder where to unpack.

-I INCLUDE, --include INCLUDE

                         Files that are added to the process

-X EXCLUDE, --exclude EXCLUDE

                         Files that are excluded from the process

Examples:

Show the list of _packages files:

        wowsunpack.exe -l -x bin\2666186\idx -p ..\..\..\res_packages

Save the list of res_packages as a list txt:

        wowsunpack.exe -l -x bin\2666186\idx -p ..\..\..\res_packages > list.txt

Unpack all the content into the default folder:

        wowsunpack.exe -x bin\2666186\idx -p ..\..\..\res_packages

Unpack all the content into the “my_unpack" folder:

        wowsunpack.exe -x bin\2666186\idx -p ..\..\..\res_packages -o my_unpack

Unpack *.swf files only:

        wowsunpack.exe -x bin\2666186\idx -p ..\..\..\res_packages -I *.swf

Unpack *.swf files only except for main_scene.swf:

        wowsunpack.exe -x bin\2666186\idx -p ..\..\..\res_packages -I *.swf -X *main_scene*


 

Referrals:

WOWS Unpack Tool program - AutoSpy
wowsunpack.exe utility - Wargaming.net

 

Submit your comments and suggestions in this thread – will try to answer all the questions regarding the program.

 

Good luck with modding!

  • Cool 5

Share this post


Link to post
Share on other sites
[LIDGE]
Players
34 posts
10,949 battles

I'm trying to unpack the file gameparams.data in a batch (with conversion to JSON, cleaning the mess and so on).

 

 

I tested about all the options presented in the console command examples but nothing work.  It seems that only the full extract is operational.

 

Here is one of the commands I used:

wowsunpack.exe --extract --include GameParams.data res_packages

 

Does anybody have a clue on what I do wrong?

Share this post


Link to post
Share on other sites
Administrator
432 posts
12 battles

Update the program.

Changes:

  • Fixed connection error to the update server.
  • Added the ability to open the download page of program components in a browser.

Share this post


Link to post
Share on other sites
[OHBOY]
[OHBOY]
Players
85 posts
12,331 battles

Hello,

When starting the .exe a windows window is popping in for a split second and that's it.
Any advice?

Share this post


Link to post
Share on other sites
Administrator
432 posts
12 battles
On 4/3/2020 at 5:25 PM, Bambel said:

When starting the .exe a windows window is popping in for a split second and that's it.

Probably you run the "wowsunpack.exe" instead "WOWSUnpackTool.exe".

Share this post


Link to post
Share on other sites
Players
7 posts
4,491 battles

I'm getting, "The system can not find the file specified..." what file? got both the unpackertool.exe and the unpacker.exe in the same folder.. help haha

Share this post


Link to post
Share on other sites
Modder
5,396 posts
24,445 battles
10 hours ago, Wuxang said:

I'm getting, "The system can not find the file specified..." what file? got both the unpackertool.exe and the unpacker.exe in the same folder.. help haha

Do You tried to set folders in settings ?

Share this post


Link to post
Share on other sites
Administrator
432 posts
12 battles

The program has been updated to version 2.0.1.57.

 

List of changes:

  1. Compatibility with the game client version 0.9.6.
  2. The option "Save only new and changed files" is now enabled by default.
  3. The option "Open content folder after unpacking" is now enabled by default.
  4. Some minor bugs fixed.
  • Cool 2

Share this post


Link to post
Share on other sites
Administrator
432 posts
12 battles

The program has been updated to version 2.0.1.60.

Updated:

  • The function of detecting the latest directory of the game client.

Changes:

  • The app now uses the path C:\Users\LocalUser\AppData\Local\Temp for its own temp files.
  • The paths fields in the Settings menu can only be changed using the Browse button.
  • The backup function for updated apps files is now independent.
  • Some other code changes.
  • Cool 1

Share this post


Link to post
Share on other sites
Administrator
432 posts
12 battles
On 2/5/2021 at 12:40 PM, Wingsofanangel said:

Pls Update the Programm some ships are not showing up in Content Folder for example Pommern

Files for this ship have not been added to the content catalog yet. Updating the program is not required, as soon as the files are added you will see them.

Share this post


Link to post
Share on other sites
Modder
248 posts
9,630 battles
On 2/5/2021 at 10:40 AM, Wingsofanangel said:

Pls Update the Programm some ships are not showing up in Content Folder for example Pommern 

Keep in mind that Pommern's name in the internal game files is still (mostly) the originally planned "Ludendorff". When ships are renamed during development, they usually don't get renamed in the internal files. It's the same for the "Großer Kurfürst" which is still called "Großdeutschland" in the internal files, or the Kremlin which still goes by "Sovetskaya Rossiya" behind the scenes.

 

If you search for "Ludendorff" in the Unpacker, you'll probably find the files that you're looking for.

Share this post


Link to post
Share on other sites
Administrator
432 posts
12 battles
On 2/19/2021 at 4:39 PM, 1MajorKoenig said:

Is the file structure changed?

What exactly can you not find? Please describe in more detail where these parts were taken earlier.

Share this post


Link to post
Share on other sites
[DREAD]
Players
10,854 posts
7,471 battles
9 hours ago, MatroseFuchs said:

What exactly can you not find? Please describe in more detail where these parts were taken earlier.

Thanks for the reply - apparently my unpacker was somehow corrupted. I downloaded a new one, reinstalled and it works now again. Thx

 

Now - maybe you can also help me also with another question: I try to make a visual Mod for the Konig as I very much dislike the Refit and the fake bow on the upgraded hull model.

 

I tried to copy the files found in GSB009 (Konig 1932) into the GSB013 mod folder and rename them accordingly. 
 

My question to you: is there a possibility to identify which of these files I actually need to have the upgrades Konig have the original bow or look in general close  to the stock version?
And which file governs the modules to be loaded onto a model? What happens when swapping out parts is (naturally) that the small modules are either in the wrong spot or fly over the model due to the changed geometry.

 

Any hints, Tipps and tricks very much appreciated!

Share this post


Link to post
Share on other sites
Administrator
432 posts
12 battles
11 hours ago, 1MajorKoenig said:

My question to you: is there a possibility to identify which of these files I actually need to have the upgrades Konig have the original bow or look in general close  to the stock version?

In this section you will find instructions for modding camouflages, I'm sure you will find answers to your questions.

Share this post


Link to post
Share on other sites
[-NSC-]
Players
15 posts
19,420 battles

Hi there!

 

Any of you guys have an idea where i can locate the repositories for clan.domination and tournament.domination maps? And also best practice for making maps for uploading to wottactic.com using resources pulled from the unpacking tool?

 

So far I've been dumping screenshots with and w/o UI enabled from training rooms, then merging/resizing/cropping and trimming the perspective, as well as adjusting exposure for dark maps... It's a hassle, and the quality is not really optimal :P In addition, the wottactic measure tool will not work with my uploaded .png files ofc

 

Any help and advice is greatly appreciated!

 

\ WeserBlitz (EU)Tears_Of_The.Desert.Clans.Domination_CB13.thumb.png.e283f6b4b311d1fb56a2b47255c006c4.png

Share this post


Link to post
Share on other sites
Players
1 post
87 battles

Hello there,

 

I'm currently planning to make a new standalone modification for the game, that requires unpacking some of the in-game voice. I've found out that .idx files in the bin/<game number>/idx folder is connected to the .pkg files inside res_packages folder, however I have no idea how to connect the metadata inside the .idx files with the data inside .pkg files. Since I'm thinking that this program knows how to do such thing, can you give an insight about it?

 

Thank you.

Share this post


Link to post
Share on other sites
Administrator
432 posts
12 battles
17 hours ago, SEA_Reroll said:

Hello there,

 

I'm currently planning to make a new standalone modification for the game, that requires unpacking some of the in-game voice. I've found out that .idx files in the bin/<game number>/idx folder is connected to the .pkg files inside res_packages folder, however I have no idea how to connect the metadata inside the .idx files with the data inside .pkg files. Since I'm thinking that this program knows how to do such thing, can you give an insight about it?

 

Thank you.

The tool published in this topic allows you to see the available resources for unpacking, select and unpack the resources you need. If what you are looking for is not there, then unfortunately it is not available.

  • Cool 1

Share this post


Link to post
Share on other sites

×