TLoD-TMD-Converter

The idea behind this tool is to preserve TMD Models as originally shown ingame(*). Much of the tools over internet add or remove stuff from the models (such as: Dragoon wings; convert Quad faces into Tri faces), maybe is not the BEST tool if you want something fast or bug free.

Also i added a very specific functionality for researchers and modders, when you export the 3D model two *.txt files will created, Primitive_per_Object will contain useful data of each primitive type used in models and also the quantity of each one. The other called TMD_Report will be created with a count number of Vertex/Normal/Primitive of each object in the file and a sum of all the file.

BETA 0.6

NOW THE TOOL USE A STABLE GRAPHICAL USER INTERFACE You check the releases and you will find a Windows Version of it (Tested in Windows 10) if not, you can compile it yourself (Sorry Linux/MAC Users i'm not so skilled to port into it).

Tested the full batch conversion of DRGN21 Files on: Processor: i5-12400F. RAM: 32 GB. SSD: Kingston SNV2S/1000g.

Total Space required approximately: up to 10 GB (When converting all the Models and Animations). Time to convert all the files: 01 Minutes 47 Seconds (average).

Keep in mind, surely this tool can be executed in lesser PC specifications, but the time to convert the models will depend on how fast your Hardware is.

A simple converter to DAE (Collada) format oriented to work with TLoD Model and animation formats, to later be imported into Blender. Python coded (recommended Python version 3.12.0 64bit).

UPDATE: CONVERSION OF ALL MODELS AND ANIMATIONS FROM SUBMAPS FILES

UPDATE: PRIMDATA DUMPING

UPDATE: COMMAND PROMPT TOOL IS TOTALLY DEPRECATED

UPDATE: CONVERSION FILE BY FILE IS NOW IN "ADVANCED CONVERSION"

UPDATE: NOW THE TOOL WORKS ONLY WITH SEVERED CHAINS, FILE DUMP

First of all you'll need to download Severed Chains, install it and run the game from it, once you get the files dump, you can continue using TLoD TMD Converter.

In the first run, the tool will ask the SC/files/... path:

files/ path: Path to files folder (which is the dump done by SC).

Then will ask you the folder you want to dump the converted files:

C:\your_modding_folder\TLoD_Models\

Now the tool will generate a new file with extension *.primdata this file will contain data from primitives if the model have some textures on it very handy to use along to Blender2TLoD-TMD, this data is very important for TMD Models

UPDATE: TOOL COMES WITH A DOCUMENT ABOUT HOW TO USE IT

----"ADVANCED CONVERSION" SUPPORT---- Model Type supported: TMD - CTMD

Animation Type Supported: Embedded CMB, Embedded LMB Type 0, Embedded SAF and SAF If no Animation data is found inside the file, will ask if you want to load one.

Keep in mind without animation Data/File loaded, the conversion only will use the original position of Objects from the model, that in most of the cases is set at the origin point of the scene.

Recommend to use the File Mapping document, to know where Models and Animations files are located.

NEW: ANIMATION FORCING --> WILL FORCE TO LOAD A SAF ANIMATION AND PLACING A DUMMY FILE, CONVERTING THIS INTO A DAE FILE, HELPFUL WHEN YOU DON'T KNOW WHAT AN ANIMATION IS

BPE Unpacking done by theflyingzamboni:

LoDModS by theflyingzamboni

LoDModS

SC done by Monoxide:

Severed Chains by Monoxide

Severed-Chains

File Mapping Documents

DRGN0 File Mapping Doc

DRGN21 File Mapping Doc

DRGN22 File Mapping Doc

DRGN23 File Mapping Doc

DRGN24 File Mapping Doc

TLOD TMD Converter - By DooMMetaL (AKA - DragoonSouls):

i want to thanks a lot to this people who came my main inspiration to learn programming!:

TheFlyingZamboni Monoxide Illeprih Zychronix

Also a special thanks to Monoxide, who did an impressive job reversing TLoD Game Engine, thanks to his job, i been able to make a converter for CTMD, SAF, CMB and LMB files!.

Also a special thanks to theflyingzamboni, who did an impressive job reversing BPE Encoding, thanks to his job i been able to convert BPE files from animations and models!.

and all the people from the TLoD Global Discord!. Cheers!.

(*) This prove to be partially true, the main problem comes with actual 3D Software, which do not support double faces using the same vertex and simply delete them without any warning for the final user, while the older version (Alpha V 0.1 which convert models into OBJ format) maintain the double faces [newer versions simply use an auto-split vertices algorithm -sorry-. Also we found some bugs related to winding of the Vertex Index in some models, this prevent to correctly form the primitives (which later will be faces) right now this is under research] -> DEPRECATED

DISCORD

You can find me here:

Discord

CHANGELOG

BETA 0.5 version

FIXING SOME LITTLE BUGS

BETA 0.5 version

ADDED CONVERSION FOR ALL THE SUBMAPS CUTS MODELS AND ANIMATIONS INCLUDING THE MAP ITSELF
FIXED SOME BREAKING BUGS
CHANGE SOME LOGIC AROUND TO FIT STANDARDS

BETA 0.4 version

FIXED MEMORY LEAK ON BATTLE MODEL CONVERSION WINDOW (THANKS TO DennytXVII REPORTING THIS ISSUE)
ADDED CONVERSION FOR DRGN21 FILES (SUBMAP FILES)
FIXED SOME BREAKING BUGS

BETA 0.3 version

FIXING LITTLE BUGS
ADDING PRIMDATA DUMP

BETA 0.2 version

PERMANENT GUI, WITH MORE OPTIONS
CHANGING MODEL CONVERSION INTO SELECTABLE LIST OF FILES TO CONVERT
CHANGING FILE-BY-FILE CONVERSION ONLY AVAILABLE AT ADVANCED CONVERSION
ADDING ANIMATION FORCING ONLY AVAILABLE AT ADVANCED CONVERSION
IMPROVEMENTS TO THE CODE AND LOGICS BEHIND IT
NOW MUCH OF THE PROCESS IS AUTOMATIC
MERGING ADDITIONS ANIMATIONS AVAILABLE
FULL AND ONLY SUPPORT TO SEVERED CHAINS FILE DUMP STRUCTURE
REMOVED THE MODEL FIXER, SINCE BROKE SOME WORKING MODELS, NOW FINDING A PROPER WAY TO DO THIS
CONTROL OVER THE WINDOW SIZE AND SCALE
ADDING A PDF DOC TO EXPLAIN HOW THIS TOOL WORKS

BETA 0.1 version

ADDING GUI FOR EASY USE OF THE TOOL!
TOTAL REFACTOR ON THE CODE TO FIT THE STANDARDS
FIX SOME RETAIL BUGS RELATED TO MODELS THAT HAVE UNUSED VERTICES IN THE BLOCK

ALPHA 0.5 version (older code)
CODE CLEANING (SOME MINOR REFACTOR AND MUCH CODE CLEAN UP).
ADDING SUPPORT FOR CONVERTING CTMD'S (FINALLY!).
ADDING SUPPORT FOR NEW ANIMATION FORMATS PRESENT ONLY IN DEFF FILES (CMB AND LMB).
ADDING SUPPORT FOR TMD FILES AND CTMD FILES WHICH HAVE ANIMATION DATA EMBEDDED.
ADDING SUPPORT FOR CONVERTING DIRECTLY TMD FILES INSIDE DEFF FILES WITHOUT HEX WORKAROUND.

ALPHA 0.4 version
CODE REFACTOR (LOGIC AND ALGORITHM REFACTOR, CODE CLEAN UP).
ADDING SUPPORT FOR CONVERTING ANIMATIONS INTO THE DAE FILE.
ADDING SUPPORT FOR MERGING SEVERAL ANIMATIONS AT ONCE IN A SINGLE FILE.
FIXED SOME LITTLE BUGS, SPECIALLY IN THE GRADIENT COLOURS. 
IMPORTANT: THERE IS A KNOW ISSUE IN SOME MODELS THAT ADD MORE FACES WHERE IS NOT NECESSARY, THIS HAPPENS
BECAUSE THOSE MODELS HAVE DUPLICATED OR MORE MULTIPLIES OF THE VERTICES OBJECTS AND I MEAN IN THE ORIGINAL BINARY FILES, 
AT THE MOMENT I HAVE NO FIX FOR THEM:
BATTLE STAGES
Phantom Ship.
Undersea Cavern.
Melbu Frahma Last Stage.
Wingly City (Moon).
Archangel Battle (Moon).
Some foes (very few) have the same issue and are under researching.

ALPHA 0.3 version
CODE REFACTOR IN COLLADA CONVERSION MODULE. (NOW FACE OF CHARACTERS ARE DUPLICATED, AND COLOUR IS CONSISTENT).
ADDED SOME NEW PRIMITIVE TYPES FOUND IN SOME FILES.
GENERAL BUGFIXES.

ALPHA 0.2 version
TOTAL REFACTOR IN CODE.
PROJECT NAME CHANGED TO A PROPER ONE.
SUPPORT TO VERTEX COLOR IN FACES.
ADDED NEW FILE TYPE TO CONVERT (*.DAE) COLLADA FILE.
SOLVED THE UV ISSUE (AT LEAST IN THE NEW FORMAT TYPE DAE).

ALPHA 0.1 version
FIRST RELEASE