Extractor for the bundle format used in the game Warhammer 40k Darktide.

Extract all files:

limn -i "C:\Program Files (x86)\Steam\steamapps\common\Warhammer 40,000 Darktide\bundle" *

Extract only lua files:

limn -i "C:\Program Files (x86)\Steam\steamapps\common\Warhammer 40,000 Darktide\bundle" lua

With the Steam version of Darktide automatic directory lookup is used when no path is specified:

limn lua

See limn --help for more options.

If a file named dictionary.txt is placed next limn.exe it will be used for reverse hash lookup.

Currently when limn is using a dictionary it will only extract files that it is able to find a name for.

limn only supports a few file types used in Darktide bundles.

Fatshark uses a private fork of LuaJIT in Darktide. All lua files are stored as LuaJIT bytecode that, aside from a header version change, is compatible with existing tooling for LuaJIT (like any decompilers).

package files in Darktide are a list of other files with a extension hash and name hash per entry.

For example most unit files share the same name as their package file which can then be referenced for the hashes of texture or other files used by that unit.

If filtering for only strings files then limn will either:

1. extract strings with known keys if a dictionary is used
2. extract all strings

texture files are stored as DDS. For mipmap levels 64KiB or larger Darktide deduplicates them to a resource file at data/**/*.

limn will export the highest quality mipmap level found.

For converting DDS to PNG texconv and ffmpeg can be used:

texconv -ft bmp -f B8G8R8A8_UNORM -y texture_file.dds
ffmpeg -i texture_file.BMP texture_file.png