README
¶
FileDiver
An unofficial Helldivers 2 game asset extractor.
Download
Extract the achive into a new folder.
The program is called "filediver.exe" (or just "filediver" on Linux). See usage.
What are "ffmpeg.exe" and "magick.exe"?
"ffmpeg.exe" (FFmpeg) and "magick.exe" (ImageMagick) are used for converting certain files. They are downloaded from official sources by the GitHub workflow that generates the .zip archive you can download.
You only need to keep them in the folder if you don't have them installed on your computer.
Usage
Windows
Navigate to the folder where you unpacked the program into. SHIFT+Right-Click in the folder and select "Open in PowerShell".
In PowerShell/Terminal, run ./filediver -h to get a list of options.
Here are some example commands:
Simply running the app should automatically detect your installation directory and dump all files into the "extracted" directory in your current folder:
./filediver
Print a detailed description of all command line options:
./filediver -h
Extract the files into a directory called "custom_dir":
./filediver -o "custom_dir"
Extract only video files:
./filediver -c "enable:video"
Extract the Super Earth anthem as mp3:
./filediver -c "audio:format=mp3" -i "content/audio/291227525.wwise_stream"
Features
File Types/Formats
- Audio: Audiokinetic wwise bnk/wem; automatically converted to WAV; other formats require FFmpeg
- Video: Bink; automatically converted to MP4 via FFmpeg (shipped with Windows binary)
- Textures: Direct Draw Surface (.dds); automatically converted to PNG via ImageMagick (shipped with Windows binary)
- Models (WIP): Stingray Unit; automatically converted to GLB (=glTF); can be imported into Blender; requires ImageMagick for textures
Planned: bones, animations
Credits/Links
This app builds on a lot of work from other people. This includes:
- Hellextractor by Xaymar
- Basic binary file structure
- Unhashed resource names/types (.txt files)
- vgmstream, ww2ogg by hcs and bnkextr by eXpl0it3r
- Wwise audio formats
Some useful discussion on the topic of HD2 resource extraction: https://reshax.com/topic/507-helldivers-2-model-extraction-help/
License
Copyright (c) Darwin Schuppan
FileDiver is licensed under the 3-Clause BSD License (https://opensource.org/license/bsd-3-clause).
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Implements LSb-First reader and writer for reading/writing arbitrary bit width integers from/to normal go byte streams.
|
Implements LSb-First reader and writer for reading/writing arbitrary bit width integers from/to normal go byte streams. |
|
"triad" describes a storage unit used in the game files.
|
"triad" describes a storage unit used in the game files. |
|
The following is mostly manually converted from vgmstream (https://github.com/vgmstream/vgmstream)
|
The following is mostly manually converted from vgmstream (https://github.com/vgmstream/vgmstream) |
|
vorbis
The following is manually converted from ww2ogg by hcs (https://github.com/hcs64/ww2ogg)
|
The following is manually converted from ww2ogg by hcs (https://github.com/hcs64/ww2ogg) |