Trackmania Game Mode Settings
Every Trackmania game mode exposes script variables (S_*) that control
how matches play out. These go inside the mode_script_settings block of
your MatchSettings XML file. Use the search and filter below to find any variable.
Cup
| Variable | Type | Default | Description |
|---|---|---|---|
| S_CupNbWinners | integer | 1 | Number of players who advance / win the Cup. |
| S_CupTimeLimit | integer | 0 | Time limit for the Cup in seconds. 0 = no limit. |
| S_CupRoundsPerMap | integer | 5 | Rounds played on each map before map change. |
| S_CupPointsLimit | integer | 100 | Total points needed to win the Cup. |
| S_WarmUpNb | integer | 0 | Number of warm-up rounds. |
| S_WarmUpDuration | integer | 30 | Duration per warm-up round in seconds. |
| S_FinishTimeout | integer | -1 | Seconds to wait after first finish. -1 = auto. |
Laps
| Variable | Type | Default | Description |
|---|---|---|---|
| S_ForceLapsNb | integer | -1 | Override the map's lap count. -1 = use map default. |
| S_TimeLimit | integer | 0 | Overall time limit per attempt in seconds. 0 = no limit. |
| S_WarmUpNb | integer | 0 | Number of warm-up rounds. |
| S_WarmUpDuration | integer | 30 | Duration of each warm-up round in seconds. |
| S_ChatTime | integer | 10 | Chat time between maps in seconds. |
Rounds
| Variable | Type | Default | Description |
|---|---|---|---|
| S_PointsLimit | integer | 100 | Points needed to win the match. |
| S_FinishTimeout | integer | -1 | Seconds to wait after first finish before ending round. -1 = auto. |
| S_UseAlternateRules | boolean | False | Use alternate points distribution system. |
| S_MaxPointsPerRound | integer | 6 | Maximum points a player can earn in one round. |
| S_WarmUpNb | integer | 0 | Number of warm-up rounds. |
| S_WarmUpDuration | integer | 30 | Duration of each warm-up round in seconds. |
| S_ChatTime | integer | 10 | Chat time between rounds in seconds. |
Team
| Variable | Type | Default | Description |
|---|---|---|---|
| S_PointsLimit | integer | 5 | Points a team needs to win. |
| S_MaxPointsPerRound | integer | 6 | Maximum points earnable in one round. |
| S_UseAlternateRules | boolean | False | Alternate points distribution for team scoring. |
| S_WarmUpNb | integer | 0 | Number of warm-up rounds. |
| S_FinishTimeout | integer | -1 | Seconds after first team finish before round ends. |
TimeAttack
| Variable | Type | Default | Description |
|---|---|---|---|
| S_TimeLimit | integer | 300 | Seconds per map. 0 = no limit. |
| S_WarmUpNb | integer | 0 | Number of warm-up rounds before the map starts. |
| S_WarmUpDuration | integer | 30 | Duration of each warm-up round in seconds. |
| S_WarmUpTimeout | integer | -1 | Seconds to force-end warm-up. -1 = auto. |
| S_ChatTime | integer | 10 | Seconds of chat time between maps. |
| S_AllowRespawn | boolean | True | Whether players can respawn during a run. |
MatchSettings XML Example
<mode_script_settings>
<setting>
<key>S_TimeLimit</key>
<value type="integer">300</value>
</setting>
<setting>
<key>S_WarmUpNb</key>
<value type="integer">1</value>
</setting>
</mode_script_settings>
The type attribute must match the variable type: integer, boolean, or text.
Run your own Trackmania server.
Rent a private Trackmania server on real hardware — full control-panel access, your mods, your configs, your rules. It's your server; run it your way.
Don't want to run it yourself? Our managed services & consulting team will set it up and keep it running for you — game servers, Windows, Linux, and cloud, from 10+ years of MSP work.