Minimaul's Saints Row 2, Saints Row: The Third, Saints Row IV and Gat Out Of Hell tools

  • Thread starter Thread starter Minimaul
  • Start date Start date
Minimaul said:
Because malicious people use UPX to pack their EXEs too. :(
Click to expand...
Then use an alternative packer? Or there is no other alternative, in which case fair enough...

Minimaul said:
I'm sure there's nothing I can say that will 100% convince you, but this site and my tools are endorsed by Volition (the makers of SR) - we have Volition staff (their community manager and some of their developers) posting on this forum, and I wrote the Steam Workshop tool for SRIV that is distributed by Volition on Steam. Do you really think this would be the case if I was sending viruses around?
Click to expand...
Oohhhh, ok. Oh didn't know SR4 had a workshop page.....got a link to that? I'm currently browsing through it and I don't see this tool(or tools) on there....

Minimaul said:
They're wwise audio files inside a special package. The wwise audio files (.wem files) are *already* a special kind of modified OGG. The soundbank tools extract the .wem and then ww2ogg does some converting to produce a normal .ogg file from the .wem. There's no transcoding involved.
Click to expand...
Ohhh, ok - in that case that's fine as long as there's no transcoding! :)

[V] IdolNinja said:
I'm the Community Developer for Volition. Our studio works directly with Minimaul on the modding tools, and we can confirm that they are not infected, and what you are seeing is a false positive.
Click to expand...
Alright then, in that case I can safely set Kaspersky to ignore that flag and or restore the quarantined file! Thanks for confirming - I take all I said about it being infected back then; though one would wonder why you haven't submitted these programs to the antivirus/malware companies so they can whitelist or for them to check themselves if it is incorrectly flagged or not...and then update their definitions database on that....surely all it takes is just upload your files to them, contact them saying something on the lines of "Hey, can you whitelist or confirm my programs are virus/malware free so they are ignored, please?" And they will reply with a "Certainly" and then sometime passes by and all your programs that once was picked up as false positives no longer are anymore and all shows clean across the board! :confused::po_O:)
 
SRF said:
though one would wonder why you haven't submitted these programs to the antivirus/malware companies so they can whitelist or for them to check themselves if it is incorrectly flagged or not...and then update their definitions database on that....surely all it takes is just upload your files to them, contact them saying something on the lines of "Hey, can you whitelist or confirm my programs are virus/malware free so they are ignored, please?" And they will reply with a "Certainly" and then sometime passes by and all your programs that once was picked up as false positives no longer are anymore and all shows clean across the board! :confused::po_O:)
Click to expand...
You put way too much trust in the antivirus programs. They are far from infallible. They are a tool. Nothing more.
While it's certainly prudent to be cautious, you can't expect every open-source programmer to submit every version of their software to every antivirus company. It's simply impractical. And we have better things to do with our time. Minimaul provides his source code which you can view yourself. That's the most you should expect from free software. If you expect more, find a paid alternative.

You've done the correct thing by investigating the source of the software. Minimaul has been endorsed by Volition, so that's a rock solid endorsement. That's actually way more than you will get from the modding tools for most games, which are frequently not even open source. In addition, he's the creator of this forum which has been around for many years. If his code had malware, it certainly wouldn't have lasted this long. I think it's safe to say that every modder on this forum has used his tools, including myself. We're very lucky to have a skilled programmer like Minimaul spending many, many hours of his personal, unpaid time to provide the modding community with these free tools. He's done the right thing by making them open-sourced. If that's not enough, I would say your expectations are unrealistic.
 
Last edited:
Quantum said:
You put way too much trust in the antivirus programs. They are far from infallible. They are a tool. Nothing more.
While it's certainly prudent to be cautious, you can't expect every open-source programmer to submit every version of their software to every antivirus company. It's simply impractical. And we have better things to do with our time. Minimaul provides his source code which you can view yourself. That's the most you should expect from free software. If you expect more, find a paid alternative.

You've done the correct thing by investigating the source of the software. Minimaul has been endorsed by Volition, so that's a rock solid endorsement. That's actually way more than you will get from the modding tools for most games, which are frequently not even open source. In addition, he's the creator of this forum which has been around for many years. If his code had malware, it certainly wouldn't have lasted this long. I think it's safe to say that every modder on this forum has used his tools, including myself. We're very lucky to have a skilled programmer like Minimaul spending many, many hours of his personal, unpaid time to provide the modding community with these free tools. He's done the right thing by making them open-sourced. If that's not enough, I would say your expectations are unrealistic.
Click to expand...
Ok fair enough - that's understandable - I have submitted the recent version 1.31 to Kaspersky so they can update their definitions on it for you....;) And now should no longer be flagged.
 
Not sure where to report bugs, if there is a proper location for such please advise and i'll post this there

Minimaul's Tools rev131 (also tested rev121)
Game: SRTT (steam version)

File In Question:
Code: 
voices.vpp_pc
1,391,007,744 bytes
SHA-1: 285af8cdb8439c61e1911b943b057884432e0fa8

"ThomasJepp.SaintsRow.RecursiveExtractor.exe" extracted the contents of "voices.vpp_pc" without any errors (removed other output lines for brevity):
Code: 
Looking for packfiles... found 1 packfiles, containing 275 files.
voices.vpp_pc Compressed: False Condensed: False
[145/275] Extracting voices.vpp_pc: voc_player_wf_media.bnk_pc... done.

File In Question:
Code: 
voc_player_wf_media.bnk_pc
32,632,832 bytes
SHA-1: 48fcc213b3ebc618495a07ef6cb579fe3c831d18

However... "ThomasJepp.SaintsRow.ExtractStreamingSoundbank.exe" throws an unhandled exception when processing the file in question:
Code: 
C:\SR4TMP>ThomasJepp.SaintsRow.ExtractStreamingSoundbank.exe srtt .\output\voices.vpp_pc\voc_player_wf_media.bnk_pc
Extracting .\output\voices.vpp_pc\voc_player_wf_media.bnk_pc to extracted-voc_player_wf_media.bnk_pc.
[1/1893] Extracting audio... done.
[1/1893] Extracting metadata... done.
[2/1893] Extracting audio... done.
[2/1893] Extracting metadata... done.
[3/1893] Extracting audio... done.
[3/1893] Extracting metadata...
Unhandled Exception: System.ArgumentException: '▲', hexadecimal value 0x1E, is an invalid character.
   at System.Xml.XmlUtf8RawTextWriter.InvalidXmlChar(Int32 ch, Byte* pDst, Boolean entitize)
   at System.Xml.XmlUtf8RawTextWriter.WriteElementTextBlock(Char* pSrc, Char* pSrcEnd)
   at System.Xml.XmlUtf8RawTextWriter.WriteString(String text)
   at System.Xml.XmlUtf8RawTextWriterIndent.WriteString(String text)
   at System.Xml.XmlWellFormedWriter.WriteString(String text)
   at ThomasJepp.SaintsRow.ExtractStreamingSoundbank.Program.Main(String[] args)

I used these 2 tools to extract hundreds of other files without any problem from SR3 as well as SR4
 
Last edited:
I just wanna chip in with my error too(but different file), I'll just put the error in a screenshot below:
Untitled.png
 
Made a .BAT Tool for Using the CMD easier
https://www.saintsrowmods.com/forum...-weapon-help-easy-bat-input.15403/#post-98209
But I get OUT OF MEMORY I USE CMD OR .BAT FILE

It worked fine before with CMD or .BAT Tool and since yesterday it stop working

What I did yesterday
- Ran .BAT Tool Multiple Times

What problems this happened too also
- Deleted old files and got new ones
- Did it with CMD and .BAT
- Cleared My Register
 
Last edited:
Minimaul said:
There is an ongoing issue with Rev 128, Rev 130 & Rev 131 and CustomizationItemClone. For many items it will fail to clone. If you need CustomizationItemClone, continue to use Rev 121: http://minimaul.saintsrowmods.com/files/tools/releases/ThomasJepp.SaintsRow-rev121.zip

This toolset is made up of several tools:

Packfile tools
  • ThomasJepp.SaintsRow.BuildPackfile.exe: A command line packfile builder that can optionally update asm_pc files when building str2_pc files. Ideal for use in batch files. Supports SR2, SRIV, SRGOOH.
  • ThomasJepp.SaintsRow.BuildPackfileGUI.exe: An easy to use GUI packfile builder that can update asm_pc files when building str2_pc files. Supports SR2, SRIV, SRGOOH.
  • ThomasJepp.SaintsRow.EditPackfile.exe: A command line tool to insert new files or replace existing files inside a vpp_pc or str2_pc file. A 64-bit version is also provided for use when working on large packfiles. Supports SR2, SRIV, SRGOOH.
  • ThomasJepp.SaintsRow.ExtractPackfile.exe: A command line packfile extractor. Ideal for use in batch files when extracting packfiles - vpp_pc and str2_pc files. Supports SR2, SRTT, SRIV, SRGOOH.
  • ThomasJepp.SaintsRow.ExtractPackfileGUI.exe: A simplified GUI packfile extractor. Ideal for use when extracting individual packfiles - vpp_pc and str2_pc files. Supports SR2, SRTT, SRIV, SRGOOH.
  • ThomasJepp.SaintsRow.RecursiveExtractor.exe: A command line tool that can extract all of the packages from a game in one operation. Requires quite a bit of disk space and takes quite a while to run. Supports SR2, SRTT, SRIV, SRGOOH.
  • ThomasJepp.SaintsRow.Stream2.exe: A command line tool that can update asm_pc files, and convert asm_pc files to and from an editable XML format. Supports SRTT, SRIV, SRGOOH.
  • ThomasJepp.SaintsRow.Stream2Update.exe: A tool that automatically extracts the necessary asm_pc files for your current mods and updates them appropriately. Supports SRIV, SRGOOH.
Localisation tools
  • ThomasJepp.SaintsRow.BuildStrings.exe: A command line localisation string builder. Converts an editable XML format to the le_strings files that the game needs. Works with non-english characters such as Japanese or Russian. Supports SR2, SRTT, SRIV, SRGOOH.
  • ThomasJepp.SaintsRow.ExtractStrings.exe: A command line localisation string extractor. Converts le_strings files to an editable XML format. Supports SR2, SRTT, SRIV, SRGOOH.
Soundbank tools
  • ThomasJepp.SaintsRow.BuildStreamingSoundbank.exe: A command line soundbank builder - for soundbanks that end in _media.bnk_pc. Supports SRTT, SRIV, SRGOOH.
  • ThomasJepp.SaintsRow.ExtractStreamingSoundbank.exe: A command line soundbank extractor for streaming soundbanks (ones that end in _media.bnk_pc). Supports SRTT, SRIV, SRGOOH.
Misc tools
  • ThomasJepp.SaintsRow.ConvertClothSim.exe: A command line tool to convert cloth simulation files (.sim_pc) between Version 2 (SRTT/SRIV) and Version 5 (SRGOOH).
  • ThomasJepp.SaintsRow.CustomizationItemClone.exe: A command line tool that clones customization items - so you can edit the clone, not the original. Supports SRIV only.

Downloads

The tools are available for download from this post (as attachments) and the source code is available at: https://github.com/saintsrowmods/SaintsRowTools

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/

Linux/SteamOS
To use these tools on Linux/SteamOS, you need an up to date version of Mono.

For Debian, Ubuntu and SteamOS, I suggest following these instructions to add the Mono repository to your APT configuration, then running apt-get install mono-complete.

Please note: ThomasJepp.SaintsRow.ExtractStreamingSoundbank can't convert audio on Linux as it relies on Windows programs where the source code is not available.

Credits
Some tools use third-party programs for full functionality:
These tools are included in the main download.

Change log
  • Revision 131:
    • Fix ExtractStrings and BuildStrings for SR2 US string files (there's no US charlist for SR2)
  • Revision 130 (2017/03/25):
    • BuildStreamingSoundbank now creates files with correct alignment, and actually repacks the lipsync data (oops!)
  • Revision 128 (2016/12/25):
    • Stream2Update will now let you select the third game in the list (oops!).
    • Generate shorter filenames for some files in CustomizationItemClone.
    • Some tweaks to language string tools internally.
  • Revision 121 (2016/10/12):
    • CustomizationItemClone now handles items with more than one wear option correctly - these seem to be mostly hairstyles.
  • Revision 120 (2016/09/23):
    • Write out the cmorph_pc file loose too for CustomizationItemClone (fixes an issue with morphs not being correctly applied in the clothing store)
    • Add a "settings.json" file that allows you to specify paths for each game. If the path is set to null the game will attempt to autodetect the paths. For now, autodetection only works on Windows. This allows tools to be used with the GOG versions of SR and the Linux/SteamOS versions. Please report any issues you hit using the tools on Linux/SteamOS especially.
    • Remove the "clean" action from ThomasJepp.SaintsRow.Stream2 - it was never intended to be actually used.
    • Update some of the usage information shown by the command line tools when you run them in a command prompt with no parameters.
  • Revision 111 (2016/05/12):
    • Fix a crash in CustomizationItemClone when an item has missing language strings.
  • Revision 110 (2016/05/12):
    • Actually package the right files this time.
  • Revision 108 (2016/05/12): - this is a broken revision, do not use!
    • Add ThomasJepp.SaintsRow.CustomizationItemClone.
  • Revision 102 (2016/05/12):
    • Add ThomasJepp.SaintsRow.ConvertClothSim to convert cloth sim files between Version 2 (SRTT/SRIV) and Version 5 (SRGOOH)
    • Add a better error message to Stream2Update when it can't find any games to update.
    • Implement lots of extra file formats including basic Peg support and static mesh support (metadata only - you can't use this to edit the contents of these files).
  • Revision 94 (2016/03/17):
    • Add support for Saints Row: The Third ASM files.
    • Updates & bugfixes to ThomasJepp.SaintsRow.dll
    • Add ThomasJepp.SaintsRow.EditPackfile - allowing for easy substitutions of files into a packfile.
  • Revision 81 (2015/10/19):
    • Include some cmd files to allow for easy soundbank extraction. Simply drag your soundbank onto one of these files to extract it:
      • extract-soundbank-sr3.cmd - for Saints Row 3
      • extract-soundbank-sr4.cmd - for Saints Row 4
      • extract-soundbank-srgooh.cmd - for Saints Row: Gat out of Hell
    • Main download now includes revorb.exe, ww2ogg.exe and the two packed codebooks files
  • Revision 79 (2015/08/21):
    • Fix building strings files when there is a hash in the file that couldn't be turned into a name.
  • Revision 78 (2015/08/20):
    • Fix ExtractStrings when working with SRTT string files - it was attempting to open SRIV only packfiles - thanks Fan of Saints!
  • Revision 77 (2015/08/20):
    • Add read-only support for Saints Row: The Third packages.
    • Fix some compile-time warnings.
    • Added MakeDummyClothSim & updated HashTester - these tools aren't included in the main distribution, but the source code is on github.
  • Revision 72 (2015/04/08):
    • Added support for Saints Row 2 package files to BuildPackfile, BuildPackfileGUI, ExtractPackfile and ExtractPackfileGUI.
  • Revision 67 (2015/04/05):
    • ExtractStreamingSoundbank and BuildStreamingSoundbank now extract and repack subtitles that are attached to voice clips. The parameters on these tools have changed!
    • ExtractStreamingSoundbank and BuildStreamingSoundbank now automatically tries to select the right codebooks for revorb. You can also override this manually with the /codebooks:<codebook file> parameter.
    • BuildStrings and ExtractStrings now work correctly on non-latin characters - so they should work on Russian/Polish/Japanese. The parameters on these tools have changed! These tools now also use an XML file format rather than an awkward text file format.
    • ExtractStrings now automatically finds your xtbl files inside the game's original packfiles and uses those.
    • Finding your game install directory is now much more reliable and should even work for cases where your game installed to a different Steam library.
  • 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.
Click to expand...

Hey, can you also work on Agents of Mayhem? I cannot find the sound vpp and i really need the songs from the game. PLEASE HELP!!!


It have same vpp_pc files but i cannot find any other tool except yours to extract it. PLEASE!
 
just downloaded this tool
but still don't know which file

i want to extract music (radio) and conversation (also radio and between crew, so funny)
help please
 
I haven't played SR4 in a long time ,i'm just installing it again atmo and going through all the mods i have archived on various dvds.
I've also forgotten what alot of the info meant when it comes to installing some mods.

What does this mean ?

"There is an ongoing issue with Rev 128, Rev 130 & Rev 131 and CustomizationItemClone. For many items it will fail to clone. If you need CustomizationItemClone, continue to use Rev 121"

Will it have a bearing on any mods i might wanna try installing ?
I've totally forgotten what "CustomizationItemClone" means.
 
bgan69 said:
I haven't played SR4 in a long time ,i'm just installing it again atmo and going through all the mods i have archived on various dvds.
I've also forgotten what alot of the info meant when it comes to installing some mods.

What does this mean ?

"There is an ongoing issue with Rev 128, Rev 130 & Rev 131 and CustomizationItemClone. For many items it will fail to clone. If you need CustomizationItemClone, continue to use Rev 121"

Will it have a bearing on any mods i might wanna try installing ?
I've totally forgotten what "CustomizationItemClone" means.
Click to expand...

What does this mean ...Will it have a bearing on any mods...
No in the sense of installing mods, but if your trying to modify or make a variation of a Clothing Item of an Item that won't produce files, then you can't make a mod of certain clothing items.

I've totally forgotten what...
CustomizationItemClone = CustomizationItem means Clothing (Shirts, Hats, Hairs, Shoes, Pants, etc) & Clone means Template Maker for modders to replace Copied Vanilla Files with Edited ones.
The tool makes/produces Template files of the Clothing Item you want via CMD, Game Name & Item Name from XTBL or XML file.
 
You must log in or register to reply here.
Back
Top