This feature has been introduced with version 0.20, with the purpose of automatically process and convert textures files provided as PNG (Portable Network Graphics) into DDS (DirectDraw Surface) texture files.
The Texture Cooker will only convert 8-bit PNG files that are following the following naming convention:
The automatic conversion happens as soon the game has to load a texture file that matches the requirements mentioned above.
During the conversion process, a temporary texture will be applied to the object(s) using that texture. The texture will appear once the conversion has completed.
The converted texture files will always be located inside
Userfolder/<gameVersion>/temp, at the same relative location of your original texture file. (Learn more about the userfolder here
If the original file is at
the converted file will be found in
When publishing a mod, only include the converted DDS texture files with it. Do not include the original PNG texture files!
Place the converted texture files in the same location of the originals, no other changes are required. Even though your materials file will be pointing to the original PNG file, the game will automatically detect the converted DDS files (if exists) and load it instead.
When manually specifying textures in a
main.materials.json file (e.g. creating a skin for a vehicle), point to the PNG texture file in the texture path. The game will automatically use the converted DDS texture file if it exists, otherwise it will first proceed to convert the PNG.