How to Use - matyalatte/UE4-DDS-Tools GitHub Wiki

[!Note] This is a manual for GUI users. See here if you use batch files.

Extraction

You can extract textures from uassets.
The steps are as follows.

  1. Run GUI.exe.
  2. Select Export from Menu.
  3. Drop .uasset (or a folder) onto the first textbox.
  4. Drop a folder onto the second textbox.
  5. Select UE version.
  6. Select texture format from Export as.
  7. Check no mipmaps if you don't need mipmaps.
  8. Click on the Export button.

export

[!Note] If a .uasset has multiple textures, they will be exported as multiple files with indices.
(e.g. If image.uasset has 10 textures, image.0.tga ~ image.9.tga will be generated.)

Injection

You can inject texture files (.dds, .tga, .hdr, etc.)
The steps are as follows.

  1. Run GUI.exe.
  2. Drop .uasset (or a folder) onto the first textbox.
  3. Drop a texture file (or a folder) onto the second textbox.
  4. Drop a folder onto the last textbox.
  5. Select UE version from the dropdown at the lower left.
  6. Check no mipmaps if you don't want to use mipmaps.
  7. Check force uncompressed if you don't want to compress textures.
  8. Click on the Inject button.

Inject

[!Note] If a .uasset has multiple textures, specify the first indexed image as a texture file.
(e.g. If you want to inject image.0.tga ~ image.9.tga to image.uasset, drop image.0.tga onto the second textbox.)

Check Version

You can check which UE versions are the same format as your assets. The steps are as follows.

  1. Run GUI.exe.
  2. Select Check version from Menu.
  3. Drop .uexp onto the textbox.
  4. Click on the Check button.

check

Folder Injection

You can use folder paths as arguments.
UE4-DDS-Tools searches the folders recursively, and run the operations for the found assets.
See here for the details.
Folder Injection · matyalatte/UE4-DDS-tools Wiki

Command Line Usage

You can use command line to run the tool.
Command Line Usage · matyalatte/UE4-DDS-tools Wiki

GUI Customization

GUI.exe is a GUI wrapper to execute commands.
It reads gui_definition.json and builds GUI from the definition.
So, you can easily customize it with notepad to use it for other CLI based tools.
See here for the details.
matyalatte/tuw: Tiny GUI wrapper for command-line tools

Run on Unix

You can use UE4-DDS-Tools on macOS and Ubuntu.
See here for the details.
For Unix Systems · matyalatte/UE4-DDS-tools Wiki

Ubuntu mac