Telltale Texture Mod Tool
![GitHub release (latest by date)](https://img.shields.io/github/v/release/iMrShadow/DDS-D3DTX-Converter)
Newer (Fork) Versions:
![Github All Releases](https://img.shields.io/github/downloads/iMrShadow/DDS-D3DTX-Converter/total.svg)
Older Versions:
Description
This is an application designed to preview and convert Telltale textures (files with the .d3dtx extension) to a more accessible format like DDS (Direct Draw Surface) and vice versa. There is also support for converting DDS to other image formats and back, although this is not recommended due to potential data loss. It works only on Windows.
DOWNLOAD THE LATEST VERSION HERE
Screenshots
![Main 1](https://github.com/Telltale-Modding-Group/DDS-D3DTX-Converter/raw/main/wiki/tutorial-screenshots/mainThumb.png)
Getting started
If you have issues or questions, redirect them to the discord server.
Supported Games
- The Walking Dead
- The Walking Dead: Season Two
- The Walking Dead: Michonne
- The Walking Dead: A New Frontier
- The Walking Dead: The Final Season
- The Walking Dead: The Telltale Definitive Series
- The Walking Dead Collection
- Minecraft: Story Mode
- Minecraft: Story Mode – Season Two
- The Wolf Among Us
- Tales from the Borderlands
- Batman: The Telltale Series
- Batman: The Enemy Within
- Guardians of the Galaxy: The Telltale Series
- Game of Thrones
- Jurassic Park
- Poker Knight 2
- Back to the Future: The Game
Supported Texture Layouts
- 2D Textures
- Volume Textures
- Cube Textures
- 2D Array Textures
- Cube Array Textures
Notes and Limitations
- This is primarily aimed for PC-platform games. In the future we may add Android/iOS support, but it's not guaranteed. More information can be found in the wiki.
- If you want support on other legacy titles, please open an issue.
- Older games do not support some texture layouts such as volumemaps or cubemaps. Please be cautious.
- Linux/MacOS are not supported even with Wine due to DirectXTexNet's mixed mode assembly.
Developers
Only for modders/developers who plan on forking/modifying/downloading the project.
There are 3 projects in this repository:
- DDS_D3DTX_Converter_GUI is the currently-maintained application with a GUI built with Avalonia UI. It has the latest features and improvements. It also has a Debug CLI.
- D3DTX_TextureConverter is a CLI app. It's older than DDS_D3DTX_Converter_GUI, which is not recommended to use. It can be still used for some of the latest Telltale games.
- TextureMod_GUI is the original GUI application built with WPF (Mahapps). It is not recommended to use as it's extremely outdated.
We utilize DirectXTexNet, a .NET wrapper around DirectXTex, allowing us to work better with DDS files.
If you want to use the console applications, you can open their relative solutions in Visual Studio. It would require you to change the code to set some parameters.
If you want to learn about the D3DTX file format we suggest you looking in the DDS_D3DTX_Converter_GUI project at TelltaleD3DTX folder. The classes there are well documented and describe the D3DTX format. Preferably, start with D3DTX_V9.cs and go upwards.
Direct Surface Draw (.dds) is a Microsoft file format, which is described in detail here. You can also check out in this folder the following classes:
- DDS_HEADER.cs
- DDS_HEADER_DX10.cs
- DDS_PIXELFORMAT.cs
Credits
- Thanks to David Matos for his original work on the old converter and its wikipedia.
- Thanks to Ivan Panayotov for creating the new GUI, adding support for more games and possibly all textures from Back to the Future: The Game (2010) and onwards.
- Thanks to Mawrak for their work on the original GUI application and its wiki, testing the software and providing critical feedback.
- Thanks to Lucas Saragosa for figuring out the Telltale formats and for his help for parsing the D3DTX correctly for all supported games. His TelltaleToolLib project served as a reference, which had a lot of influence in the conversion process.
- Thanks to Arrizble for creating a tutorial, testing the software on Minecraft: Story mode series and providing critical feedback.
- Thanks to Knollad Knolladious for testing the software on Minecraft: Story mode series. Array textures support was added due to his discoveries.
- Thanks to the DirectXTexNet's authors for providing an amazing wrapper.
- Thanks to SVG Repo for their amazing GUI icons.
Current Developer Note
Special thanks to David for introducing me to the Telltale Modding Community and modding as a whole, and for being a good mentor along the way.
Special thanks to Lucas for helping me add support for older games and made me understand the Telltale Tool Engine better.