1. This site uses cookies. By continuing to use this site, you are agreeing to our use of cookies. Learn More.

Minimaul's Saints Row IV and Gat Out Of Hell tools

Discussion in 'Tool Releases' started by Minimaul, Aug 19, 2013.

  1. Minimaul

    Minimaul Site owner Staff Member

    Fresh out of the box for Saints Row IV day 1, I bring you:
    • ThomasJepp.SaintsRow.BuildPackfile.exe: a command line packfile builder for Saints Row IV and Gat Out Of Hell. Can optionally update asm_pc files when building str2_pc files. Ideal for use in batch files when building packfiles.
    • ThomasJepp.SaintsRow.BuildPackfileGUI.exe: a simplified GUI packfile builder for Saints Row IV and Gat Out Of Hell. Can also update asm_pc files when building str2_pc files. Ideal for use when building one-off packfiles.
    • ThomasJepp.SaintsRow.BuildStreamingSoundbank.exe: a command line soundbank builder for Saints Row: The Third, Saints Row IV and Gat Out Of Hell. Builds streaming soundbanks (ones that end in _media.bnk_pc).
    • ThomasJepp.SaintsRow.BuildStrings.exe: a command line localisation string builder for Saints Row 2, Saints Row: The Third, Saints Row IV and Saints Row: Gat Out Of Hell.
    • ThomasJepp.SaintsRow.ExtractPackfile.exe: command line packfile extractor for Saints Row IV and Gat Out Of Hell. Ideal for use in batch files when extracting packfiles - vpp_pc and str2_pc files.
    • ThomasJepp.SaintsRow.ExtractPackfileGUI.exe: a simplified GUI packfile extractor for Saints Row IV and Gat Out Of Hell. Ideal for use when extracting individual packfiles - vpp_pc and str2_pc files.
    • ThomasJepp.SaintsRow.ExtractStreamingSoundbank.exe: a command line soundbank extractor for Saints Row: The Third, Saints Row IV and Gat Out Of Hell. Extracts streaming soundbanks (ones that end in _media.bnk_pc).
    • ThomasJepp.SaintsRow.ExtractStrings.exe: a command line localisation string extractor for Saints Row 2, Saints Row: The Third, Saints Row IV and Saints Row: Gat Out Of Hell.
    • ThomasJepp.SaintsRow.RecursiveExtractor.exe: a command line tool that can extract all of the packages for Saints Row IV or Saints Row: Gat Out Of Hell in one operation. Requires quite a bit of disk space.
    • ThomasJepp.SaintsRow.Stream2.exe: a command line tool that can update asm_pc files as well as provide information about the contents of asm_pc files.
    • ThomasJepp.SaintsRow.Stream2Update.exe: a tool that automatically extracts the necessary asm_pc files for your current mods and updates them appropriately.
    The tools are available for download from this post (as attachments) and the source code is (as always) available at: https://github.com/tomjepp/ThomasJepp.SaintsRow

    These tools and their source code are licensed to you under the terms included in "license.txt" in the downloadable copy. You can also view a copy online.

    For help with these tools, post in the Get Help/Troubleshooting forum for Saints Row IV, and for tutorials on how to use these tools check out the Guides and Tutorials forum.

    If you're a more advanced user trying to use the command line tools, just run them in a command prompt with no parameters and they should show you a reasonable amount of help text.

    Only the most recent version is attached to this post, and it is the only recommended version to use. If you have a problem with the tools, make sure you are using the most recent version before you report a bug!
    If you need to, you can download older versions from: http://minimaul.saintsrowmods.com/files/tools/releases/

    Extra requirements
    Some tools have extra requirements for full functionality:
    • ThomasJepp.SaintsRow.ExtractStreamingSoundbank: to convert the extracted audio to a format you can listen to (.ogg), the following extra programs are needed:
      • ww2ogg.exe: used to convert the extracted audio to OGG Vorbis format. Get it from: http://www.hcs64.com/vgm_ripping.html
        Extract it then copy ww2ogg.exe and packed_codebooks_aoTuV_603.bin to the same folder as ExtractStreamingSoundbank.
      • revorb.exe: used to fix the OGG files so they play correctly in more players. Download it from: http://yirkha.fud.cz/progs/foobar2000/revorb.exe
        Copy it to the same folder as ExtractStreamingSoundbank.

    Change log
    • Revision 54 (2015/02/17):
      • Add two new modes to Stream2 - "toxml" and "toasm" - these convert ASM files to/from easily editable XML files.

        To convert to an XML file:
        ThomasJepp.SaintsRow.Stream2.exe customize_item.asm_pc toxml
        This will create customize_item.xml

        To convert back to an ASM file:
        ThomasJepp.SaintsRow.Stream2.exe customize_item.xml toasm
        This will create customize_item.asm_pc
    • Revision 50 (2015/01/31):
      • When overwriting old files, make sure that we actually *replace* the old file rather than just opening the old one. This meant that if we were overwriting a file with one that was smaller, the contents of the old file were left on the end. (oops!)
    • Revision 49 (2015/01/29):
      • Make Steam2Update ignore the "mods" folder if it exists - this folder has never worked for all mods and shouldn't be used. Thanks to Arioh for noticing this was a problem with GOOH!
    • Revision 47 (2015/01/25):
      • Add BuildStreamingSoundbank and ExtractStreamingSoundbank for manipulating streamed soundbanks. ExtractStreamingSoundbank can also be used to convert audio when extracting.
      • Fix a bug with extracting already modified packfiles that are condensed and compressed (such as soundboot.vpp_pc).
      • ExtractPackfile will now create an "extracted-" prefix on extracted packfiles if you do not specify an output directory.
    • Revision 32 (2015/01/20):
      • Add some missing SRIV archives to the built-in lists.
      • If you try to use the GUI extractor to extract a packfile to the same folder it was already in, a "extracted-" prefix will be added to the folder name.
      • Add support for Gat Out Of Hell in Stream2Update. Stream2Update now detects games when it first runs and allows you to select the game you wish to update.
    • Revision 22 (2013/09/21):
      • Make Stream2Update check that the paths it finds for SRIV in the registry are actually correct. Try some backup paths if they are not.
      • Add the correct settings for dlc3.vpp_pc, dlc4.vpp_pc, patch_compressed.vpp_pc and patch_uncompressed.vpp_pc to the built-in list of packfiles.
      • Fix extracting preload_anim.vpp_pc and preload_rigs.vpp_pc.
      • Fix building preload_anim.vpp_pc, preload_rigs.vpp_pc, and soundboot.vpp_pc.
    • Revision 18 (2013/08/31):
      • Don't automatically close Stream2Update when finished.
    • Revision 17 (2013/08/31):
      • Tiny change to ThomasJepp.SaintsRow.Stream2Update.
    • Revision 16 (2013/08/31):
      • added ThomasJepp.SaintsRow.Stream2Update
      • fixed building normal vpp_pc files - all vpp_pc files now build and work OK except preload_anim.vpp_pc, preload_rigs.vpp_pc and soundboot.vpp_pc.
    • Revision 12 (2013/08/19): first release.
     

    Attached Files:

    Last edited: Feb 19, 2015
  2. 100000% awesome already!
     
  3. Well clothing mods be possible with the tools?
     
  4. [V] IdolNinja

    [V] IdolNinja Volition Staff

    Weapons/clothing/vehicle/npc creation will be possible in the future with the actual SDK release. These are just basic tools for file formats and editing scripts/tables; similar to our existing SR2 and SRTT tools. Keep your eye on the announcements forum for future details regarding the SDK.
     
  5. The command line version doesn't appear to be working (at least for me). I drag and drop a SR4 VPP_PC file onto the executable and it gives me an unhandled IO exception stating that "a file or directory with the same name already exists".

    The GUI version works like a champ.

    EDIT: Just noticed that your tools for SR4 are including the extension as part of the folder name. So instead of getting "misc_tables" for a folder name it now gives "misc_tables.vpp_pc".
     
    Last edited: Aug 20, 2013
  6. Minimaul

    Minimaul Site owner Staff Member

    Yeah - you will need to extract files to a different folder to the ones that they came from. Drag/drop isn't really ideal.
     
  7. Thank you, kind sir.

    EDIT: Yup, I was being dumb, didn't think to try the extract packfile app on the str2_pc file. Works like a charm.
     
    Last edited by a moderator: Aug 20, 2013
  8. Sooo I tried packing the files back into a vpp_pc file and it just corrupts my game (luckily I backed up the specific file). And no it isn't because I changed something and mucked it up. I even tried just extracting the files, which worked, then not even touching it and packing it back into a vpp_pc and it still makes my game crash.
     
  9. Now that I have unpacked the str2_pc file of my choosing, how do I unpack the .cvbm_pc and .gvbm_pc files inside of it? The unpacker tool crashes when I try, if I'm supposed to use it. [using GUI version]
     
  10. Minimaul

    Minimaul Site owner Staff Member

    Try the SR3 texture tools - if they won't work then you'll have to wait for someone to release something that will.

    Can you tell me which vpp_pc you're trying to repack?