README
¶
Filediver
An unofficial Helldivers 2 game asset extractor.
Download
Filediver
Extract the archive. This will create a folder named filediver, where everything relevant is located.
The program is called "filediver.exe" (or just "filediver" on Linux). See usage.
What is "ffmpeg.exe"?
"ffmpeg.exe" (FFmpeg) is used for converting video and audio files. It is downloaded from an official source by the GitHub workflow that generates the .zip archive you can download.
You only need to keep it in the folder if you don't have it installed on your computer already.
Helper scripts (scripts_dist)
Extract the helper scripts achive into the filediver folder (the same folder containing the executable, e.g. filediver.exe).
Usage
Windows
Navigate to the filediver folder (the one containing filediver.exe). SHIFT+Right-Click in the folder and select "Open in PowerShell".
In PowerShell/Terminal, run ./filediver -h to get a list of options.
See Wiki
Filediver GUI (experimental)
An experimental graphical interface for Filediver, WIP.
Allows you to explore several file types using the preview, and to interactively select your extraction options.
Download Filediver GUI
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
- Models (WIP): Stingray Unit; automatically converted to GLB (=glTF); can be imported into Blender; ability to automatically apply Thejudsub's accurate HD2 Shader; for importing bones, see Importing Bones
Planned: animations
Importing Bones
When importing the .glb into blender, you need to change the "Bone Dir" option from "Blender" to "Temperance", or you will see huge spheres for bones.
Links
- HD 2 Archive Labelling (IDs can be used with -t option)
- Helldivers Archive Discord server
Credits
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
- ImageMagick
- DDS texture decoding
- Accurate HD2 Shader by Thejudsub on the Helldivers Archive Discord server
- The most accurate Blender material replicating the game's procedural shaders
Some useful discussion on the topic of HD2 resource extraction: https://reshax.com/topic/507-helldivers-2-model-extraction-help/
Hacking
- Install Go
go run ./cmd/filediver-cli
License
Copyright (c) filediver contributors
FileDiver is licensed under the 3-Clause BSD License (https://opensource.org/license/bsd-3-clause).
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. |
|
cmd
|
|
|
filediver-cli
command
|
|
|
filediver-gui
command
|
|
|
filediver-gui/getter
Getter downloads assets from GitHub releases.
|
Getter downloads assets from GitHub releases. |
|
filediver-gui/imgui_wrapper
Package imgui_wrapper provides a basic framework for an IMGui app.
|
Package imgui_wrapper provides a basic framework for an IMGui app. |
|
filediver-gui/imutils
ImGui utilities.
|
ImGui utilities. |
|
tools/animation-name-dumper
command
|
|
|
tools/crossref-checker
command
|
|
|
tools/hash-tool
command
|
|
|
tools/hd2grep
command
|
|
|
tools/physics-name-dumper
command
|
|
|
generate/combine
command
|
|
|
generate/wwise_streams
command
|
|
|
"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) |