Brown Dust 2 Repacker

A simple tool useful to mod Brown Dust 2 bundles. Thanks to Bingle for the help with this repacker.

Before to use this tool:

• Download and install Microsoft C++ Build Tools, and after that install the necessary dependencies following this video guide:

Usage for repack:

1. Run the script Y___make_backup_before_update_game.py before to update your game if you already have mods located in the game folder. The script will make a backup of your mods to the folder "Backup" so you will not lose your mods when you update your game.
2. Update your game.
3. Go to the folder "Backup" and copy the folders there to "Modded Bundles".
4. Run A___GET_RAW_FILES.bat, the .bat file will run the scripts to get the raw files from the game folders and it will make a copy to the folder "Original Bundles".
5. Run 1___REPACKER.bat to start the repacking process. And now just wait, the Terminal window will close when the repacking is done.
6. If everything worked with no issues you will see your repacked files saved in the folder "Repacked".
7. Copy those folders from "Repacked" and paste them in your game folder "Gamfs_BrownDust II" manually, located in %USERPROFILE%\AppData\LocalLow\Unity\Gamfs_BrownDust II.
8. Replace the files and that's it.

NOTE: The script Z___clean_folders.py is just to clean the folders used by the tool when you finished to repack your mods, so you can just ignore this script and delete the files or folders you don't need anymore manually. This script doesn't clean the folder "Repacked".

Usage to install mods:

1. Run D___copy_raw_data_files_2.py to copy the raw files from the game folder directly to the folders "Original Bundles" and "Modded Bundles", and run C___delete_unnecessary_files.py to remove any not necessary file inside these folders.
2. Run 3___add_bundle_extension.py.
3. Run 4___extract_assets.py and wait until the process finishes.
4. Here I got some modded assets to use as sample. Or you can download any other mod where the creator provided the .atlas/.skel/.png assets.
5. Go to the folder "Extracted Assets" and you will see some folders that contain the raw assets We extracted previously on step 3 (various files .atlas / .skel / .png).
6. Copy the modded assets you downloaded and paste them in their corresponding locations replacing the raw assets.
7. Run 5___bingle_kxde_repacker_LZ4_compressor___auto-RGBA32.py and the tool will start to repack the files using the modded assets you replaced in "Extracted Assets". The Terminal window should close when the repacking is done.
8. Run 6___remove_bundle_extension.py.
9. If everything worked with no issues you will see your repacked files saved in the folder "Repacked".
10. Copy those folders from "Repacked" and paste them in your game folder "Gamfs_BrownDust II" manually, located in %USERPROFILE%\AppData\LocalLow\Unity\Gamfs_BrownDust II.
11. Replace the files and that's it.

Usage to install your own mods (for modders):

If you make your own mods you can use this tool to save some time too. You can use this tool to extract/export the assets to "Extracted Assets" and then you can start to work with the assets from there, save the changes to the assets and when you're ready to import the assets back to the bundles you can run 5___bingle_kxde_repacker_LZ4_compressor___auto-RGBA32.py and 6___remove_bundle_extension.py and your modified files will be saved to "Repacked". Then just move them to your game folder and that's it.

Happy modding! ^‿^