TM_DS_Wii_Mesh_Converter
=========================

Converts TrackMania DS, TrackMania Turbo DS, and TrackMania Wii game files
into .dae (3D models) and .png (textures/2D graphics), keeping the game's
own folder structure.

This is a single standalone .exe. Nothing else needs to be installed.


HOW TO USE
----------

Option 1 - Drag & drop:
  Drag one of the supported files listed below directly onto
  TM_DS_Wii_Mesh_Converter.exe.

Option 2 - Command line:
  TM_DS_Wii_Mesh_Converter.exe "path\to\file"

Option 3 - No argument:
  Double-click the .exe, then type/paste the file path when asked.

The console window stays open at the end so you can read the summary;
press Enter to close it.


SUPPORTED FILES
---------------

  TrackMania DS / Turbo DS   : .nds
  TrackMania Wii             : .wbfs, .iso, .wia, .rvz, .gcz


OUTPUT
------

Everything is written next to the input file, in a new folder named:

  "<file name> - Converted"

Inside it, the game's own folder structure is preserved (e.g. Graphics\
Tracks\...), with the converted files placed alongside the originals in
an "Output" (3D models + textures) or "Output2D" (2D graphics) folder.


IMPORTING INTO BLENDER
-----------------------

Use Blender's built-in "File > Import > Collada (.dae)", or the included
TrackMania Mesh Importer add-on for batch/folder import.


NOTES
-----

- A few materials (checkpoint/start/control-wall trigger volumes, or
  materials genuinely never given a texture in the original game data)
  will import with no image -- this reflects the source game data, not
  a conversion error.
- Re-running the converter on the same file overwrites previous results
  in its "... - Converted" folder.
