How to Change Maps and Match Settings on Your Trackmania Server

A Trackmania server plays a match settings file, which is a playlist of maps plus the game mode and its rules. Adding a map means putting the file on the server and adding it to that playlist.

Upload the maps

1. Stop the server.
2. In the panel open Files and go to:

   UserData/Maps/

3. Upload your map files. Keeping them in a subfolder per campaign or per author is normal and keeps the playlist readable.

Edit the match settings

Match settings files live in:

UserData/Maps/MatchSettings/

They are XML. A simple one looks like this:

<playlist>
  <gameinfos>
    <game_mode>0</game_mode>
    <script_name>TimeAttack.Script.txt</script_name>
  </gameinfos>
  <filter>
    <is_lan>1</is_lan>
    <is_internet>1</is_internet>
    <sort_index>1000</sort_index>
  </filter>
  <startindex>0</startindex>
  <map>
    <file>MyMaps/track01.Map.Gbx</file>
  </map>
  <map>
    <file>MyMaps/track02.Map.Gbx</file>
  </map>
</playlist>

• The file path is relative to UserData/Maps/.
• Maps play in the order listed, then the playlist loops.
• script_name selects the mode, for example time attack, rounds, team or knockout. Use the script names shipped with your server version.

Point the server at the playlist

The match settings file the server loads is set on your server's Startup Settings page, reachable from the server overview, as the game settings parameter. Set it to your file name, then start the server.

Mode settings

Round counts, time limits and points limits belong to the mode script and are set in the <mode_script_settings> block inside the match settings file. Each mode has its own setting names, listed in the script's own documentation.

Changing maps live

From an admin session in game you can skip to the next map, restart the current one, or load a different match settings file without stopping the server. That is the fastest way to test a new playlist.

If a map does not load

• Check the path in the playlist matches the actual file location and capitalisation.
• Read the panel console. It names any map it could not find at startup.
• A map built for a different Trackmania version will not load. The console reports it as invalid.