/Telltale-Texture-Tool

A GUI application designed to make texture mods possible for Telltale Tool games. It converts D3DTX files to PNG, DDS, TGA and other image formats and vice versa.

Primary LanguageC#MIT LicenseMIT

Telltale Texture Tool

Wiki GitHub release (latest by date) Discord Github All Releases

Description

This is an application designed to preview and convert Telltale textures (files with the .d3dtx extension) to more accessible formats like PNG, JPEG, DDS, TGA, HDR, TIFF, BMP and vice versa.

Main Features

  • Supports converting D3DTX files to more common formats like PNG, JPEG, DDS, TGA, HDR, BMP, TIFF and vice versa.
  • Supports most, if not all PC textures. However, some are not decrypted.
  • PS Vita, PS3, PS4, Nintendo Switch, Xbox 360, iOS and Android platforms for newer games.
  • Supports 2D, 2D array, cubemap and volumemap textures.
  • Mip generation, normal map tools, automatic compression and platform swizzling/deswizzling (works for all file types).
  • Batch conversion.
  • A texture previewer with pan and zoom, and sliders for mips and faces.
  • A file explorer with navigation and additional functions.
  • Cross-platform support.

DOWNLOAD THE LATEST VERSION HERE

Screenshots

Main 1

Getting started

Quick Video Tutorial

Wiki

If you have issues or questions, please redirect them to the discord server or open an issue.

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
  • Sam and Max Save the World Remastered
  • Sam and Max Beyond Time and Space Remastered
  • Sam and Max The Devil’s playhouse Remastered
  • Sam & Max Save the World
  • Sam & Max Beyond Time and Space
  • Sam & Max: The Devil’s Playhouse
  • Tales from the Borderlands
  • Batman: The Telltale Series
  • Batman: The Enemy Within
  • Guardians of the Galaxy: The Telltale Series
  • Game of Thrones
  • Jurassic Park
  • Back to the Future: The Game
  • Hector: Badge of Carnage
  • Telltale Texas Hold’em
  • Bone: Out from Boneville
  • Bone: The Great Cow Race
  • Strong Bad’s Cool Game for Attractive People
  • Wallace & Gromit’s Grand Adventures
  • Tales of Monkey Island
  • Hector: Badge of Carnage
  • Nelson Tethers: Puzzle Agent
  • Puzzle Agent 2
  • Poker Night at the Inventory
  • Poker Knight 2
  • CSI: 3 Dimensions of Murder
  • CSI: Hard Evidence
  • CSI: Deadly Intent
  • CSI: Fatal Conspiracy
  • Law & Order: Legacies

Notes and Limitations

  1. It does not decrypt textures, please use Telltale Explorer to get the decrypted ones.
  2. MacOS support is not tested. Please report any issues!

Developers

Only for modders/developers who plan on forking/modifying/downloading the project.

There are 3 projects in this repository:

  • TelltaleTextureTool is the currently-maintained application with a GUI built with Avalonia UI. It has the latest features and improvements.

The other 2 projects are located in the Archive folder.

  • D3DTX_TextureConverter is an older CLI app version of the tool, 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 Hexa.NET.DirectXTex, a .NET wrapper of DirectXTex, allowing us to work better with texture files.

v2.5.0 will not have a CLI version, while v2.4.0 does support it.

If you want to learn about the D3DTX file format we suggest you looking here. The classes there are well documented and describe the D3DTX format. Preferably, start with D3DTX_V9.cs and go upwards. There is also the official documentation. Direct Surface Draw (.dds) is a Microsoft file format, which is described in detail here.

Credits

  • Thanks to Ivan Panayotov for creating the new GUI and its features, adding support for possibly all games, which include mobile and console platforms, and creating the new documentation.
  • Thanks to David Matos for his original work on the old converter and its wikipedia.
  • 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 Knollad Knolladious for his outstanding feedback, research and knowledge. His discoveries from Minecraft: Story mode series led to support other texture layouts, console and mobile platforms, as well as many other things.
  • Thanks to Arrizble for creating a tutorial, testing the software on Minecraft: Story mode series and providing critical feedback.
  • Thanks to Juna Meinhold for their cross-platform DirectXTex wrapper.
  • Thanks to the DirectXTexNet's authors for providing an amazing stable and reliable wrapper.
  • Thanks to Chuck Walbourn for DirectXTex and adding support for obsolete Direct3D9 formats, which are used by older Telltale games.
  • 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.