This guide covers admin tools and server management for your Trackmania dedicated server on Legion Hosting. For initial setup and configuration, see our Trackmania Server Setup Guide.
Server Administration Overview
Trackmania dedicated servers are managed primarily through the XML configuration files and external server controllers. The server itself does not have a traditional in-game console like Source engine games.
Configuration File
The main server configuration is in XML format:
UserData/Config/dedicated_cfg.txtKey sections within the configuration:
| Setting Path | Description |
|---|---|
masterserver_account > login |
Dedicated server login (from Trackmania website) |
masterserver_account > password |
Dedicated server password |
server_options > name |
Server name displayed in browser |
server_options > comment |
Server description |
server_options > password |
Join password |
server_options > max_players |
Maximum number of players |
server_options > max_spectators |
Maximum number of spectators |
system_config > server_port |
Server port (managed by GPanel) |
Match Settings
Match settings files define your track playlist and game mode. They are stored in:
MatchSettings/The default file is example.txt. To create a custom playlist:
- Copy
example.txtto a new file (e.g.,custom.txt) - Edit the file to add or remove track entries
- Update the
GAME_CONFIGstartup variable to point to your new file (e.g.,MatchSettings\custom.txt) - Restart the server
Managing Maps
Adding Maps
- Download track files (
.Map.Gbx) from the Trackmania community - Upload them to
UserData/Maps/via SFTP - Add the track references to your match settings file
- Restart the server to load the new tracks
Server Controllers
For advanced administration, many Trackmania server operators use external server controllers. Popular options include:
- PyPlanet — Python-based controller with plugin support
- UASECO — PHP-based controller with extensive features
- EvoSC — Modern C# server controller
These controllers connect via the XML-RPC interface and provide features like chat commands, player statistics, map voting, and auto-queue management.
Server Management via GPanel
| Action | How To |
|---|---|
| Start/Stop/Restart Server | Use the power controls on GPanel's main page |
| Change Server Name | Edit SERVER_NAME in Startup tab |
| Set Server Password | Edit SERVER_PASSWORD in Startup tab |
| Change Match Settings | Edit GAME_CONFIG in Startup tab |
| Edit Configuration | File Manager or SFTP → UserData/Config/dedicated_cfg.txt |
| View Console Output | Check the Console tab in GPanel |
Troubleshooting
Server Not Starting
- Verify
MASTERSERVER_LOGINandMASTERSERVER_PASSWORDare correctly set - Ensure the credentials were created at trackmania.com/player/dedicated-servers
- Check the console output for authentication errors
Players Cannot Find Server
- Confirm the master server credentials are valid and the server started successfully
- Check that the match settings file exists and is properly formatted
- Wait a few minutes for the server to register with the master server
Related Articles
Need Help?
If you need further assistance with your Trackmania server, our support team is ready to help. Submit a support ticket and we will respond as soon as possible.
