Maniaplanet Scripts

A collection of my personal scripts and tools for Maniaplanet/Trackmania.

Download Map Dependencies.ps1

Most TM maps you’ll find download external resources like signs, sound effects, texture mods, etc. Eventually, these links die, permanently killing old community maps. If you want to help preserve data for a map to play it in perpetuity without relying on these links to remain available, you can download the external resources for your maps to your Maniaplanet user folder. This script helps automate that. Just download the file and save it as .ps1.

Usage Instructions:

1. Download and save Download Map Dependencies.ps1 somewhere.
2. Open the file with Notepad, and look for this section near the top: $ManiaplanetDocuments = "". Edit it to look like this: $ManiaplanetDocuments = "C:\Users\<username>\Documents\Maniaplanet". You can copy the Maniaplanet folder path from the top of your Windows Explorer to find it.
3. Close the editor.
4. Create a new text file right next to the script, called download_deps or download_deps.txt, if you have file extensions showing.
5. Open that file, and paste the <dep> lines from your map here.
6. Close the file.
7. Finally, right-click on the PowerShell script, and select "Run with PowerShell". The script will download all available data for the map and merge it into your Maniaplanet user data.

How to find the <dep> links:

1. Download and install GbxDump.
2. Open your map file with GbxDump, look for the lines, and copy them.
3. Paste them into download_deps.txt.

Note on logging:

The log file generated by the script is very small, and it's recommended to keep it, as if you ever need to help archive or restore map data, it can help you retrace which data belongs to which map.

Upgrade Maps to MP4.cmd

If you're trying to play extremely old maps and your car is falling through the track or other parts of it look broken, you probably need to re-compute the shadows. This script helps with that.

Usage Instructions:

1. Download and save Upgrade Maps to MP4.cmd somewhere.
2. Open the file with a text editor, and modify the paths to point to your Maniaplanet install folder and game data (Documents) folder. DO NOT include quotes!!
3. Temporarily move ALL maps OTHER than the ones you want to upgrade OUT of your maps folder.
4. Close the game.
5. Run the script.
6. Once done, you can move your other maps back.
7. The old map files will be permanently overwritten.

(MP4 just means Maniaplanet 4, the 4th version of the game engine. Also, there's normally no reason to change Lightmap quality unless you're having issues, in which case you can change to Medium or Low. Low is useful in the track editor for quickly computing large maps to play test them before re-computing as High and publishing.)