Trackmania Server Configuration (dedicated_cfg.txt)

Trackmania Server Configuration (dedicated_cfg.txt)

The primary server configuration file is an XML document located at:

• TMNF/TMUF: GameData/Config/dedicated_cfg.txt
• ManiaPlanet: UserData/Config/dedicated_cfg.txt

A template (dedicated_cfg.default.txt) is included in the server download — copy it to dedicated_cfg.txt and edit from there.

Full Configuration Reference

<?xml version="1.0" encoding="utf-8" ?>
<dedicated>

  <!-- Admin password tiers -->
  <authorization_levels>
    <level>
      <name>SuperAdmin</name>
      <password>YourSuperAdminPassword</password>
    </level>
    <level>
      <name>Admin</name>
      <password>YourAdminPassword</password>
    </level>
    <level>
      <name>User</name>
      <password>User</password>
    </level>
  </authorization_levels>

  <!-- Nadeo account (required to appear in the public browser) -->
  <masterserver_account>
    <login>your_nadeo_login</login>
    <password>your_nadeo_password</password>
    <!-- TMNF only: set your country code -->
    <nation>GBR</nation>
    <!-- ManiaPlanet only: replace nation with validation_key -->
    <!-- <validation_key>your_validation_key</validation_key> -->
  </masterserver_account>

  <system_config>
    <!-- Connection type: LAN, DSL_512, DSL_1024, DSL_2048, DSL_4096, DSL_8096 -->
    <connection_type>DSL_4096</connection_type>
    <!-- Ports -->
    <server_port>2350</server_port>
    <server_p2p_port>3450</server_p2p_port>
    <xmlrpc_port>5000</xmlrpc_port>
    <!-- Set to True only if your XMLRPC controller is on another machine -->
    <xmlrpc_allowremote>False</xmlrpc_allowremote>
    <!-- ManiaPlanet only: select the game environment/title -->
    <!-- TMStadium | TMCanyon | TMValley | TMLagoon | SMStorm -->
    <!-- <title>TMStadium</title> -->
  </system_config>

  <server_options>
    <!-- Display name in server browser -->
    <name>My Trackmania Server</name>
    <comment>Welcome! Have fun.</comment>
    <!-- Join password: leave blank for a public server -->
    <password></password>
    <!-- Spectator password -->
    <password_spectator></password_spectator>
    <!-- Player and spectator limits -->
    <max_players>32</max_players>
    <max_spectators>10</max_spectators>
    <!-- Ladder mode: inactive | normal -->
    <ladder_mode>normal</ladder_mode>
    <!-- P2P settings -->
    <enable_p2p_upload>True</enable_p2p_upload>
    <enable_p2p_download>True</enable_p2p_download>
    <!-- Vote settings -->
    <callvote_timeout>60000</callvote_timeout>
    <!-- Ratio of players required to pass a vote (0.5 = majority) -->
    <callvote_ratio>0.5</callvote_ratio>
    <!-- Allow players to download maps from the server -->
    <allow_challenge_download>True</allow_challenge_download>
  </server_options>

</dedicated>

Key Settings Explained

Admin Password Tiers

These passwords are used by XMLRPC controllers (XASECO, PyPlanet, etc.) to authenticate. Change all three from their defaults before exposing the server.

Nadeo Masterserver Account

A registered Nadeo account (free) is required for your server to appear in the public browser. Create one at https://nadeo.com (TMNF) or via ManiaPlanet.

For ManiaPlanet, replace <nation> with <validation_key> — the key is obtained from your ManiaPlanet account settings.

Connection Type

Use DSL_4096 or higher if your server has a modern internet connection. This setting affects how the server reports bandwidth to the Nadeo masterserver; using an undersized value can cause clients to receive poor ghosting/replay data.

Applying Changes

Stop the server, edit dedicated_cfg.txt, and restart. The config is read only at startup.