ataulien / blender-trackmania-tools

Simplifies working with Trackmania 2020 Items in Blender.
MIT License
18 stars 0 forks source link

Unofficial Trackmania 2020 integration for Blender.


Blender Trackmania Tools


Blender Trackmania Tools

You want to create custom Items for Trackmania 2020 using Blender, but you don't want to fiddle with NadeoImporters XML files? This Blender-Addon integrates the NadeoImporter into Blender and packs it into a handy Export-button!

Example

Installation

To use this addon, you need to do the following:

  1. Download the NadeoImporter from here: https://nadeo-download.cdn.ubi.com/trackmania/NadeoImporter_2021_01_19.zip

  2. Extract the NadeoImporter to your games install-location, so that all files are in the same folder as Trackmania.exe.

    As of now, it has to be one of the following paths: (Other locations will not work!)

    • C:\Program Files\Epic Games\TrackmaniaNext
    • C:\Program Files\Ubisoft\Ubisoft Game Launcher\games\Trackmania
    • C:\Program Files\Trackmania
  3. Download the latest release of the Addon (TrackmaniaExport.py)

  4. In Blender, go to Edit -> Preferences -> Add-Ons -> Install... and select the addon file you just downloaded.

  5. Search for Trackmania and enable the addon! (Make sure you are in the Community-tab)

Usage

Create your model in Blender as usual, then export it as Trackmania Item (.item.gbx).

The NadeoImporter requires the files to be put at very specific locations. Therefore, you don't need to chose a location, as the Addon will handle that for you.

Where are the exported files?

The finished Items will be placed at Documents\Trackmania\Items\BlenderTrackmaniaExport.

How to change Materials?

The Addon is still lacking in this regard, as it won't show all the available materials and does not have the corresponding textures. However, if you name your Blender material one of the following, the correct material will be used ingame:

UV-Layers

If the Addon finds that your meshes are lacking the UV-layers required by the NadeoImporter, it will modify the meshes so they conform to what the NadeoImporter expects. You may need to tweak th UV-layers afterwards if you find your lighting to look bad.

Icons

The Addon will automatically use Blender to render an Icon for your Item. If you want the Icon to look somewhat good, you should posision the camera properly and add some lighting. Sun-lights will not be exported into the Items and are therefore good to make the Icon look pretty.

Known Issues

This Addon is still under development, here are some known issues/shortcommings/planned features: