How to setup a Maniaplanet Dedicated Server [Tutorial]
Moderator: NADEO
How to setup a Maniaplanet Dedicated Server [Tutorial]
Dedicated server setup tutorial
INDEX
1. Installing dedicated server and titlepacks you wish to run
2. Install startup maps and configuring matchsettings
3. Configure dedicated server
3.1 Ladder server
4. Start dedicated server
For more detailed infos, please refer the official documentation:
https://doc.maniaplanet.com/dedicated-server
INDEX
1. Installing dedicated server and titlepacks you wish to run
2. Install startup maps and configuring matchsettings
3. Configure dedicated server
3.1 Ladder server
4. Start dedicated server
For more detailed infos, please refer the official documentation:
https://doc.maniaplanet.com/dedicated-server
Last edited by reaby on 05 Apr 2018, 11:20, edited 6 times in total.
1. Installing dedicated server and title packs you wish to run
1. Installing dedicated server and title packs you wish to run
You can get the latest dedicated server always here:
http://files.v04.maniaplanet.com/server ... Latest.zip
Unzip the file at directory for example c:\dedicated\maniaplanet\ on linux maybe /opt/maniaplanet/ is good, but it's up to you where to place the dedicated server files. On windows good rule is not to have spaces and use only alpha-numeric (a-z and 0-9) values on the directory name.
Next step is to just start the dedicated executable once. On windows just double click the ManiaplanetServer.exe on Linux you might type:
It will not start yet properly, and you will get errors. Don't worry it's all fine, since we've not configured the server. This is though important, because it will generate additional directory structures which you'll need to complete the tutorial.
Next step is to download the title pack(s) you wish the dedicated to be run, in this tutorial I'm using stadium as example
and the file you need is: https://v4.live.maniaplanet.com/ingame/ ... e.Pack.gbx
now place the file at: dedicated\UserData\Packs
Here is a list of the default title packs for your convenience:
Trackmania
TMStadium@nadeo
TMCanyon@nadeo
TMValley@nadeo
TMLagoon@nadeo
Shootmania
SMStorm@nadeo
SMStormSiege@nadeolabs
SMStormElite@nadeolabs
SMStormRoyal@nadeolabs
SMStormBattle@nadeolabs
SMStormWarlords@nadeolabs
SMStormCombo@nadeolabs
SMStormJoust@nadeolabs
If you wish to run other title packs you have installed for the game --> you can get the title pack from your game's packs data folder:
C:\Users\*your username*\Documents\ManiaPlanet\Packs
You can get the latest dedicated server always here:
http://files.v04.maniaplanet.com/server ... Latest.zip
Unzip the file at directory for example c:\dedicated\maniaplanet\ on linux maybe /opt/maniaplanet/ is good, but it's up to you where to place the dedicated server files. On windows good rule is not to have spaces and use only alpha-numeric (a-z and 0-9) values on the directory name.
Next step is to just start the dedicated executable once. On windows just double click the ManiaplanetServer.exe on Linux you might type:
Code: Select all
./ManiaPlanetServer
Next step is to download the title pack(s) you wish the dedicated to be run, in this tutorial I'm using stadium as example
and the file you need is: https://v4.live.maniaplanet.com/ingame/ ... e.Pack.gbx
now place the file at: dedicated\UserData\Packs
Here is a list of the default title packs for your convenience:
Trackmania
TMStadium@nadeo
TMCanyon@nadeo
TMValley@nadeo
TMLagoon@nadeo
Shootmania
SMStorm@nadeo
SMStormSiege@nadeolabs
SMStormElite@nadeolabs
SMStormRoyal@nadeolabs
SMStormBattle@nadeolabs
SMStormWarlords@nadeolabs
SMStormCombo@nadeolabs
SMStormJoust@nadeolabs
If you wish to run other title packs you have installed for the game --> you can get the title pack from your game's packs data folder:
C:\Users\*your username*\Documents\ManiaPlanet\Packs
Last edited by reaby on 18 Jan 2020, 22:03, edited 5 times in total.
2. Install startup maps and configuring matchsettings
2. Install startup maps and configuring match settings
You need some maps and a match settings file to run dedicated. Unfortunately the dedicated server doesn't come with initial maps anymore... so you'll need to either create a map using in game map editor or download the map/maps you wish to play. A good place to get maps is Mania-Exchange where you find a good community to build and share maps also many server controllers allows you to install maps directly in game without restarting the server.
Since we're going to install Stadium title pack, click on the following link:
https://tm.mania-exchange.com/tracks/42034/stadium-a01 click on the download and place the file at dedicated\UserData\Maps
You can easily filter the search and so on.. and for shootmania head on to https://sm.mania-exchange.com/ to get your initial map(s)and for other trackmania maps: https://tm.mania-exchange.com
Next step is to get the default match settings file:
There used to be a default one at dedicated server, but since the title packs are now separated from dedicated server there is no default file anymore. Instead there's nice service by Nadeo to generate the default match settings file for any title pack available at in-game store.
You find the helper at the player page: https://www.maniaplanet.com/account/ded ... ers/helper
Login using your in-game account and fill in Search term:"Stadium" --> which should give popup for Trackmania² Stadium
You see many different modes here. Most commonly used game mode TimeAttack is the last entry. Now select and copy the contents at your clipboard (ctrl-a, ctrl-c)
Next open your favorite text editor, most common ones would be: notepad++ on windows or nano on linux.
Then paste (ctrl-v) the contents to new empty file at editor, you can save, but last thing here is to add the downloaded map for the match settings:
Good place to add your maps is just before the closing tag </playlist>, so keep that the last line and place the maps before that.
Here's example for the map we downloaded:
Now is good time to save the file. Usually this file is named "maplist.txt", but you really can choose really whatever name you wish. This tutorial will use maplist.txt and this file is your match settings file.
Maps are relative to dedicatedserver\UserData\Maps. So you can have sub folders, so if you have maps on a sub folder, the syntax is:
On Linux use "/" as folder separator.
Example of maplist.txt -file
You need some maps and a match settings file to run dedicated. Unfortunately the dedicated server doesn't come with initial maps anymore... so you'll need to either create a map using in game map editor or download the map/maps you wish to play. A good place to get maps is Mania-Exchange where you find a good community to build and share maps also many server controllers allows you to install maps directly in game without restarting the server.
Since we're going to install Stadium title pack, click on the following link:
https://tm.mania-exchange.com/tracks/42034/stadium-a01 click on the download and place the file at dedicated\UserData\Maps
You can easily filter the search and so on.. and for shootmania head on to https://sm.mania-exchange.com/ to get your initial map(s)and for other trackmania maps: https://tm.mania-exchange.com
Next step is to get the default match settings file:
There used to be a default one at dedicated server, but since the title packs are now separated from dedicated server there is no default file anymore. Instead there's nice service by Nadeo to generate the default match settings file for any title pack available at in-game store.
You find the helper at the player page: https://www.maniaplanet.com/account/ded ... ers/helper
Login using your in-game account and fill in Search term:"Stadium" --> which should give popup for Trackmania² Stadium
You see many different modes here. Most commonly used game mode TimeAttack is the last entry. Now select and copy the contents at your clipboard (ctrl-a, ctrl-c)
Next open your favorite text editor, most common ones would be: notepad++ on windows or nano on linux.
Then paste (ctrl-v) the contents to new empty file at editor, you can save, but last thing here is to add the downloaded map for the match settings:
Good place to add your maps is just before the closing tag </playlist>, so keep that the last line and place the maps before that.
Here's example for the map we downloaded:
Code: Select all
<map>
<file>A01.Map.Gbx</file>
</map>
Maps are relative to dedicatedserver\UserData\Maps. So you can have sub folders, so if you have maps on a sub folder, the syntax is:
Code: Select all
<map>
<file>SubFolder\A01.Map.Gbx</file>
</map>
Example of maplist.txt -file
Code: Select all
<?xml version="1.0" encoding="UTF-8"?>
<playlist>
<gameinfos>
<game_mode>0</game_mode>
<chat_time>10000</chat_time>
<finishtimeout>1</finishtimeout>
<allwarmupduration>0</allwarmupduration>
<disablerespawn>0</disablerespawn>
<forceshowallopponents>0</forceshowallopponents>
<script_name><![CDATA[TimeAttack.Script.txt]]></script_name>
</gameinfos>
<filter>
<is_lan>1</is_lan>
<is_internet>1</is_internet>
<is_solo>0</is_solo>
<is_hotseat>0</is_hotseat>
<sort_index>1000</sort_index>
<random_map_order>0</random_map_order>
</filter>
<script_settings>
<setting name="S_ChatTime" type="integer" value="10"/>
<setting name="S_UseClublinks" type="boolean" value="0"/>
<setting name="S_UseClublinksSponsors" type="boolean" value="0"/>
<setting name="S_NeutralEmblemUrl" type="text" value=""/>
<setting name="S_ScriptEnvironment" type="text" value="production"/>
<setting name="S_AllowRespawn" type="boolean" value="1"/>
<setting name="S_UseLegacyXmlRpcCallbacks" type="boolean" value="1"/>
<setting name="S_WarmUpNb" type="integer" value="0"/>
<setting name="S_WarmUpDuration" type="integer" value="0"/>
<setting name="S_TimeLimit" type="integer" value="300"/>
</script_settings>
<startindex>0</startindex>
<map>
<file>A01.Map.Gbx</file>
</map>
</playlist>
Last edited by reaby on 18 Jan 2020, 22:21, edited 7 times in total.
3. Configure dedicated server
3. Configure dedicated server
You need a server account to run dedicated servers, so head to create new dedicated server account: https://www.maniaplanet.com/account/dedicated-servers. Note: you wish to use only lowercase letters [a-z] and numbers [0-9] for dedicated server account name. If the name contains underscores or capital letters some features, like sending planets doesn't work.
At this point you should have created a dedicated server account... So let's then configure dedicated server so we can run it:
go to "dedicated\UserData\Config\dedicated_cfg.default.txt" and copy it to "dedicated_cfg.txt"
You could rename the file as well, but copying is far better in case you host multiple servers. Since you have the default as reference.
You'll find section looking like this at the start of file:
Fill in your dedicated account credentials here.
For clarity an example how to fill these files:
If you wish to enable planets (in-game currency) for the server account, fill your main account validation key too. You find the validation key with the initial registration email send when you purchased the game, in case you've lost the mail you can obtain new one at: https://www.maniaplanet.com/account/validation-code. Also you need to send some, say 1000 planets, to the dedicated server login, for this use the in-game mail: open manialink browser (navigation button at top bar) and type "#mailto=" (ofc without using "") or use player page https://www.maniaplanet.com/account/planets.
Next fill in the server name and optionally the comment:
You may wish to disable p2p upload and downloads, this will save alot bandwidth from the server.
Depending on your connection speed: raise the connection limits, this helps the maps to change faster.
Here you also can change the default ports.
If you run multiple servers on same machine change you need to define unique port for each new one. for example: 5000,5001,5002.. If you run game on same machine as dedicated server, it's encouraged to change the ports +1 for this config.
Next you should check and open these ports at your firewall and/or if you have configured NAT at for home router then you need to assign port forward. You can search web for more info, just search for "port forward tutorial".
Xmlrpc port (default: 5000) is used for server controllers. This port you don't need to forward usually, as it's used for local host usually. If you setup server controller afterwards, this is the port you need to enter for the controller to work.
In case you wonder the title setting. You don't need the this setting at all since we'll use command line argument to override it. Usually you can just ignore this, but you can also remove the line from config.
3.1 Ladder servers
There's something you need to know to enable your server for other than 0-50k ladder rank.
First check the ladder server rules here at forums: viewforum.php?f=459
Raising the ladder limits will cost you in-game currency named Planets, for new server owners the amounts can be quite big as seen below.
So you might want to ask your friends help with this. Here's the amounts for your reference:
0-60k: 10000 Planets
0-70k: 20000 Planets
0-80k: 40000 Planets
0-90k: 80000 Planets
Race Of Champions server:
0-100k: 80000 Planets
To apply this ladder limits, visit ladder server config at player page. First fill in the title pack, then it opens new view asking for: server login, ladder limit and finally you'll need your account validation key to complete (the same you used at config above).
To make dedicated server a ladder server you'll need to edit dedicated_cfg.txt and find following line:
(If for some reason you're missing this line at dedicated config, you should add it and the two additional lines at <server_options> section)
Add the two additional lines below:
You need a server account to run dedicated servers, so head to create new dedicated server account: https://www.maniaplanet.com/account/dedicated-servers. Note: you wish to use only lowercase letters [a-z] and numbers [0-9] for dedicated server account name. If the name contains underscores or capital letters some features, like sending planets doesn't work.
At this point you should have created a dedicated server account... So let's then configure dedicated server so we can run it:
go to "dedicated\UserData\Config\dedicated_cfg.default.txt" and copy it to "dedicated_cfg.txt"
You could rename the file as well, but copying is far better in case you host multiple servers. Since you have the default as reference.
You'll find section looking like this at the start of file:
Code: Select all
<masterserver_account>
<login></login>
<password></password>
<validation_key></validation_key>
</masterserver_account>
For clarity an example how to fill these files:
Code: Select all
<masterserver_account>
<login>toto</login>
<password>foobar</password>
<validation_key>LOL</validation_key>
</masterserver_account>
Next fill in the server name and optionally the comment:
Code: Select all
<name></name>
<comment></comment>
Depending on your connection speed: raise the connection limits, this helps the maps to change faster.
Code: Select all
<connection_uploadrate>10000</connection_uploadrate> <!-- Kbits per second -->
<connection_downloadrate>10000</connection_downloadrate> <!-- Kbits per second -->
If you run multiple servers on same machine change you need to define unique port for each new one. for example: 5000,5001,5002.. If you run game on same machine as dedicated server, it's encouraged to change the ports +1 for this config.
Next you should check and open these ports at your firewall and/or if you have configured NAT at for home router then you need to assign port forward. You can search web for more info, just search for "port forward tutorial".
Xmlrpc port (default: 5000) is used for server controllers. This port you don't need to forward usually, as it's used for local host usually. If you setup server controller afterwards, this is the port you need to enter for the controller to work.
Code: Select all
<server_port>2350</server_port>
<server_p2p_port>3450</server_p2p_port>
<xmlrpc_port>5000</xmlrpc_port>
Code: Select all
<title>SMStorm</title>
3.1 Ladder servers
There's something you need to know to enable your server for other than 0-50k ladder rank.
First check the ladder server rules here at forums: viewforum.php?f=459
Raising the ladder limits will cost you in-game currency named Planets, for new server owners the amounts can be quite big as seen below.
So you might want to ask your friends help with this. Here's the amounts for your reference:
0-60k: 10000 Planets
0-70k: 20000 Planets
0-80k: 40000 Planets
0-90k: 80000 Planets
Race Of Champions server:
0-100k: 80000 Planets
To apply this ladder limits, visit ladder server config at player page. First fill in the title pack, then it opens new view asking for: server login, ladder limit and finally you'll need your account validation key to complete (the same you used at config above).
To make dedicated server a ladder server you'll need to edit dedicated_cfg.txt and find following line:
(If for some reason you're missing this line at dedicated config, you should add it and the two additional lines at <server_options> section)
Code: Select all
<ladder_mode>forced</ladder_mode>
Add the two additional lines below:
Code: Select all
<ladder_serverlimit_min>0</ladder_serverlimit_min>
<ladder_serverlimit_max>60000</ladder_serverlimit_max>
Last edited by reaby on 21 Feb 2020, 18:54, edited 10 times in total.
4. Start dedicated server
4. Start dedicated server
Detailed list of available command line options: https://doc.maniaplanet.com/dedicated-s ... mmand-line
To start server you'll need at minimum set: title, dedicated_cfg and game_settings
If you run other title packs than stadium, the titleId is usually same as file name without the extension: .Pack.GbX
At windows you can create a new file and call it "stadium.bat":
On Linux you can use your favorite text editor, like "nano stadium.sh" to create needed starter file:
On some Linux systems you might need to add runnable flag for the filesystem, you can do it with chmod:
On Windows: double click on the stadium.bat and you should have your dedicated server running.
On Linux: run the file:
In case your dedicated server doesn't start, check the console log for more details:
You can find it at dedicated\Logs\
If you have tried to start multiple times, it's the the newest file or is in doubt just delete the folder and try once, then you have only one log at the folder.
If you need to see console-log in the actual console, add argument "/noDaemon" to the start line, this will help you troubleshoot easier.
In case you'll encounter an error, please check the documentation for more detailed view about the error:
https://doc.maniaplanet.com/dedicated-s ... ent-errors
Appendix: Known errors
When you see this error, please make sure you start the title pack once in game at your main account, as of the account you registered the dedicated server to. After you have gained access to the title pack at game, the dedicated starts to work normally
Detailed list of available command line options: https://doc.maniaplanet.com/dedicated-s ... mmand-line
To start server you'll need at minimum set: title, dedicated_cfg and game_settings
If you run other title packs than stadium, the titleId is usually same as file name without the extension: .Pack.GbX
At windows you can create a new file and call it "stadium.bat":
Code: Select all
echo off
ManiaPlanetServer /title=TMStadium@nadeo /dedicated_cfg=dedicated_cfg.txt /game_settings=MatchSettings/maplist.txt
if %errorlevel% NEQ 0 pause
Code: Select all
#!/bin/bash
./ManiaPlanetServer /title=TMStadium@nadeo /dedicated_cfg=dedicated_cfg.txt /game_settings=MatchSettings/maplist.txt
Code: Select all
sudo chmod +x ManiaPlanetServer
sudo chmod +x stadium.sh
On Linux: run the file:
Code: Select all
./stadium.sh
You can find it at dedicated\Logs\
If you have tried to start multiple times, it's the the newest file or is in doubt just delete the folder and try once, then you have only one log at the folder.
If you need to see console-log in the actual console, add argument "/noDaemon" to the start line, this will help you troubleshoot easier.
In case you'll encounter an error, please check the documentation for more detailed view about the error:
https://doc.maniaplanet.com/dedicated-s ... ent-errors
Appendix: Known errors
Code: Select all
[YYYY/MM/DD hh:mm:ii] This account hasn't access to all needed packages.
[YYYY/MM/DD hh:mm:ii] Please wait...
[YYYY/MM/DD hh:mm:ii]...master server error: (125) This account does not have rights to perform this action.
[YYYY/MM/DD hh:mm:ii] Unable to buy ?????????.
This account does not have rights to perform this action.
[YYYY/MM/DD hh:mm:ii] ...ERROR: Load failed. Could not get access to '??????'.
[YYYY/MM/DD hh:mm:ii] Could not install or update the title's files...
Last edited by reaby on 18 Jan 2020, 22:37, edited 12 times in total.
How to setup a Maniaplanet Dedicated Server [Tutorial]
Done.
To keep the tutorial clean and usable, please use dedicated server topic to ask any additional questions.
Post this thread for additional infos and tips on setuping.
To keep the tutorial clean and usable, please use dedicated server topic to ask any additional questions.
Post this thread for additional infos and tips on setuping.
Re: How to setup a Maniaplanet Dedicated Server [Tutorial]
Great, thanks for writing this, reaby
Re: How to setup a Maniaplanet Dedicated Server [Tutorial]
GG Reaby for this tutorial
And thank you TMarc for having linked it in the thread useful links: viewtopic.php?f=264&t=25029&start=0
And thank you TMarc for having linked it in the thread useful links: viewtopic.php?f=264&t=25029&start=0
Ubisoft Support
Your Player Page
More information about maniaplanet, support, contents, community activities: useful links
ManiaPlanet technical documentation portal (Dedicated server, Mediatracker, ManiaLink, ManiaScript, Titles...)
Your Player Page
More information about maniaplanet, support, contents, community activities: useful links
ManiaPlanet technical documentation portal (Dedicated server, Mediatracker, ManiaLink, ManiaScript, Titles...)
Re: How to setup a Maniaplanet Dedicated Server [Tutorial]
You're welcome
But there is no need to thank me for that since adding the link is rather self-evident
But there is no need to thank me for that since adding the link is rather self-evident
-
- Posts: 2
- Joined: 08 Mar 2018, 08:21
Re: How to setup a Maniaplanet Dedicated Server [Tutorial]
Setting the Maniaplanet dedicated server is really helpful for me, thanks Reaby...
Who is online
Users browsing this forum: No registered users and 2 guests