filediver

README

Filediver

An unofficial Helldivers 2 game asset extractor.

Download

Filediver

• Windows (64-bit)
• Linux (64-bit)

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)

• Windows (64-bit)

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.

Here are some example commands:

(you can use right-click to paste your current clipboard to the PowerShell terminal)

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"

Extract the DP-00 Tactical armor set: Combine several models into one file, then import into Blender with Thejudsub's accurate shader applied.

Requires Helper Scripts to be downloaded and unzipped to the same folder filediver is:

./filediver -c "unit:single_glb=true,format=blend" -t "0x3d8cf2088ed56091" -i "0x76cf8e26aad1bf7e.unit" -o "extracted/DP-00-Tactical/"

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.

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
• 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) Darwin Schuppan and contributors

FileDiver is licensed under the 3-Clause BSD License (https://opensource.org/license/bsd-3-clause).