Getting Started

If you have not installed EvoSC already, you can follow this guide.

Bugs, issues or suggestions

If you found a bug or have a issue with EvoSC, please make a report in the Github issues:

If you also have a suggestion or improvement to the controller, you can post them there as well. Any other general questions can be asked in our Discord server.

The directory structure

In the EvoSC installation there are three noteworthy directories:

It may happen at times that you would find the cache folder interesting as you may need to clear or modify the cache in order to fix some problems.

Add yourself as master admin

Before you do anything, you may want to add yourself as a master admin so that you have access to all the features in-game. To do this you can run the command:

php esc add:admin YourLoginHere

If you are already on your server, you will have to rejoin for the rights to take effect.

The server configuration

You can find the server configuration in the file config/server.config.json. This file might be useful to know about to edit some the behavior of the controller and connection to the dedicated server. Here are explanation for some of options:

Option Description
login The login of your dedicated server account.
ip The host/IP address of your dedicated server.
port This is the XMLRPC port of your dedicated server.
rpc.login The super admin username of your dedicated server.
rpc.password The super admin password of your dedicated server.
default-matchsettings This is the file that will be the default MatchSettings file of your server.
map-cooldown This option controls how often a map can be played. The numnber indicates how many maps must be played before a map can be played again.
afk-timeout How long a player must stay afk for them to be forced into spectator mode.
echoes.join If enabled, the controller will show player join messages in the chat.
echoes.leave If enabled, the controller will show message of players leaving the server.


Customizing the theme

The file config/theme.config.json contains options for customizing the colors of your EvoSC installation.

All the colors are based on the HTML HEX color format. You can find a color picker that generates these HEX values here.

The colors under the chat option uses a slightly different format. The general text formatting of the Trackmania games uses a three digit hex code instead of six. You can find some colors and read more about it here.


Enabling and Disabling modules

The modules are what gives EvoSC it's features and functionality in general. Every module has a configuration file attached to them. You can find these under the config/ directory.

In a module config file there is always a option called enabled. You can enable a module by setting this to true and disable it by setting it to false.

Adding maps from Trackmania Exchange

You can find a bunch of maps from the exchange websites, there are two exchange websites in concern for this controller:

For Trackmania 2020 use
For Trackmania 2 use

You can easily add maps from TMX/MX with the add command. In order to add a map, find your map on the exchange website and note down the Track ID. Then add the map with the command:

//add track-id

Where track-id is the numeric id you noted down.

Revision #10
Created 18 July 2020 16:15:21 by snixtho
Updated 18 July 2020 17:10:40 by snixtho