Skip to content

Latest commit

ย 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
ย 
ย 

README.md

TT-Decomp Banner

TT-Decomp

Telltale Decompilation (TT-Decomp) is a reverse engineering initiative focused on decompiling and documenting the custom proprietary engine used by Telltale Games. Our current priority is understanding and reconstructing the internals of Minecraft: Story Mode โ€“ Season 1 Complete Edition, with an eye toward expanding into other Telltale titles as our knowledge and tooling grow.


๐ŸŽฏ Mission Statement

Our goals include:

  • Decompiling game binaries to reconstruct original logic.
  • Documenting engine systems, scripting VMs, file formats, and pipelines.
  • Building a foundation for modding, restoration, and educational insight.
  • Fostering an open, research-focused community.

๐Ÿ“Œ Current Focus: Minecraft Story Mode โ€“ Season 1

We are currently focused on the Complete Edition of Minecraft: Story Mode โ€“ Season 1, due to:

  • Its representative use of Telltale's later engine builds.
  • Its popularity and preservation importance.
  • The diversity of assets and subsystems it includes.

Why this version?

This edition consolidates all episodes into a single package, offering a comprehensive example of the engine in action, from scripting to assets to runtime behavior.


๐Ÿ” Scope of Work

  • Decompilation

    • Analyzing executable binaries and virtual machines.
    • Reconstructing scripting logic from compiled .luac or bytecode.
  • Documentation

    • File format specs (e.g., .ttarch, .d3dtx, .landb, etc.).
    • Engine features and toolchains.
    • Script VM internals and API surfaces.
  • Tools

    • Asset extractors and converters.
    • Bytecode disassemblers and decompilers.
    • Visualization utilities.

๐ŸŽฎ Expanding the Scope

While Minecraft: Story Mode is our current focus, we welcome community interest and contributions for other Telltale titles, including but not limited to:

  • The Walking Dead series
  • The Wolf Among Us
  • Tales from the Borderlands
  • Batman: The Telltale Series
  • Sam & Max (reboots)

Feel free to open issues or start new repositories for these games.


๐Ÿ“‚ Repositories

Key repos under the organization:

  • engine-docs โ€“ Open documentation on engine structure, file formats, etc.

๐Ÿค How to Contribute

Whether you're an expert RE veteran or just starting out, there are many ways to help:

  • Share research findings
  • Reverse engineer systems
  • Write or improve docs
  • Test and validate tools
  • Suggest improvements or feature ideas

โš–๏ธ Legal

TT-Decomp does not distribute any game assets, binaries, or proprietary content.
All work is done for educational and preservation purposes under the principles of fair use.


๐Ÿ“œ License

Please refer to each repository for license information.


๐Ÿ’ฌ Contact

  • GitHub Issues โ€“ Bug reports and feature requests
  • Discord - Reach out to me under the username "apfelteesaft" on Discord!

Reverse engineering history, one game at a time.

โ€” TT-Decomp