Introducing
How are we doing it?
- We assume that you are working on a Windows operating system and you are extracting the ZIP- and edit the config files on it.
- We use
Trackmania Canyon
as TitlePack, so you will have a running Maniaplanet Dedicated Server with theCanyon
environment. Of course you can replaceCanyon
with e.g.Stadium
to use that TitlePack.
Tutorial
Thanks to Hoerli there is now a video tutorial in german which teaches you to how to install UASECO:
Scenarios
In this manual I present two scenarios of an typical Maniaplanet Dedicated Server installation. There are more possibilities then just these two, but i can not handle all of them. You could also use a VirtualBox on your Windows computer and the VirtualBox simulates a computer which runs Linux (e.g. Ubuntu). On that you can install the Linux variant of a Maniaplanet dedicated server.
Scenario No.1: Hosted in a data center (24/7)
You have a so called dedicated server
which is running
Linux and is located inside of a data center and it is available 24/7 from the internet.
This is the default scenario for this manual.
Scenario No.2: Hosted at home
You want to install the Maniaplanet Dedicated Server on your computer which is running Windows and is located at your home.
All steps required an extra handling, files or tools are marked with @home
.
UASECO has been successfully tested with
Operation System
- ArchLinux 2018.09.01 (64-bit)
- CentOS 6.x (64-bit)
- Debian 7.x (64-bit)
- FreeBSD 10.x (64-bit)
- openSUSE 12.x, 13.x (32-bit, 64-bit)
- openSUSE Leap 42.x (64-bit)
- Ubuntu Server 18.x (64-bit), 16.x (64-bit), 12.x (32-bit)
- Windows 7 (32-bit, 64-bit)
- Windows 8 (32-bit)
- Windows 10 (64-bit)
PHP
- 7.2.x
- 7.3.x
MySQL Community Edition
- 5.1.x
- 5.5.x
- 5.6.x
- 5.7.x
MariaDB
- 5.5.x
- 10.0.x
- 10.1.x
- 10.3.x
- 10.4.x
WAMP environments @home
- Uniform Server ZeroXIII 13.3.2 (no installation required)
- USBWebserver 8.6 (no installation required)
- XAMPP 1.8.3
- WampServer 2.5
- VertrigoServ 2.35
Path Structure
This documentation uses a defined path structure which looks like this:
Maniaplanet dedicated server
GameServer\
GameServer\GameData\
GameServer\Packs\
GameServer\UserData\Config\
GameServer\UserData\Maps\MatchSettings\
GameServer\UserData\Replays\GReplays\
GameServer\UserData\Replays\VReplays\
UASECO server controller
uaseco\cache\
uaseco\cache\mapimages\
uaseco\cache\webrequest\
uaseco\config\
uaseco\docs\
uaseco\docs\dedicated server\
uaseco\includes\
uaseco\includes\core\
uaseco\includes\core\XmlRpc\
uaseco\includes\dedimania\
uaseco\includes\maniaexchange\
uaseco\includes\musicserver\
uaseco\includes\musicserver\getid3\
uaseco\locales\
uaseco\logs\
uaseco\newinstall\
uaseco\newinstall\config\
uaseco\newinstall\database\
uaseco\newinstall\dedicated server\
uaseco\newinstall\locales\
uaseco\plugins\
Requirements
UASECO installation
To run UASECO and a Maniaplanet Dedicated Server the minimum requirements are:
PHP
PHP have to be allowed to use the function
exec()
for theWebRequest
class, so make sure that thephp.ini
setting atdisable_functions
excludeexec
which thephp-cli
executable is using!For TLS/SSL connections you have to make sure, that you have setup the
openssl.cafile
to an up-to-datecert.pem
, download and install instructions coming later.
PHP/7.2.0 or newer, in where the following extensions have to be enabled:
- Optional: Exchangeable Image Information (exif)
- Required: File Transfer Protocol (ftp)
- Required: Iconv character set conversion facility (iconv)
- Required: Image Processing and GD (GD Library)
- Required: JavaScript Object Notation (json)
- Required: LibXML (libxml)
- Required: Multibyte String (mbstring)
- Required: MySQL Improved (mysqli)
- Required: SimpleXML (SimpleXML)
You can install the extension by using this command line (replace
7.2
with the wanted PHP release):Debian, Ubuntu... (apt-get)
sudo apt-get install php-pear php7.2-common php7.2-mysql php7.2-curl php7.2-gd \
php7.2-json php7.2-mbstring php7.2-xml php7.2-ftp php7.2-iconv php7.2-zip php7.2-dev
Arch Linux (pacman)
pacman -S apache mariadb php php-apache php-gd
Database
You can choose between MySQL and MariaDB, UASECO supports both:
MySQL/5.1.0 or newer (5.7.x recommended), in where the following extensions have to be enabled:
- Required: InnoDB Storage Engine
MariaDB/5.5.20 or newer (10.1.x recommended), in where the following extensions have to be enabled:
- Required: XtraDB or InnoDB Storage Engine
Maniaplanet
Maniaplanet Dedicated Server version 2019-02-27_14_00
or newer, and requires:
- XML-RPC API-Version
2013-04-16
or newer - ModeScript API-Version
2.5.0
or newer
The Maniaplanet Dedicated Server and UASECO has to run on the same physical machine, otherwise UASECO is not able to read all map files from the Maniaplanet Dedicated Server playlist.
Recommendations
UASECO installation
These are my recommendations for a Maniaplanet Dedicated Server with UASECO and I use these software in this manual.
PHP
Operation System
- Arch Linux latest
WAMP environments @home
- Uniform Server ZeroXIII (no installation required)
Tools
- Text Editor Notepad++ (open source)
- SFTP, SCP and FTP client WinSCP (Free software)
- SSH client PuTTY (open source)
If you have already installed a text editor which can handle utf8 files correct, then you do not need Notepad++ (the included Windows Notepad can not handle it!). WinSCP is only required if you want to transfer the Maniaplanet Dedicated Server and UASECO on your dedicated server inside the data center.
Annotation
Notepad++
Make sure that the XML config files you edit are always stored UTF-8
encoded, you have to select the encoding Encode in Encoded in UTF-8 without BOM
in the menu:
WinSCP
Make sure that you transfer all the files in Binary
and not as Text
.
Downloads
Bunch of required files
Before we are able to start the installation process, we need to download all theses files and store them onto your harddrive into a folder.
PHP
Download the actual cert.pem
file from the curl project: direct link or download page.
Maniaplanet dedicated server
Download the latest release of the Maniaplanet dedicated server 2019-02-27_14_00
Maniaplanet campaings maps
Download the default campaings maps: all A-Maps from TMCanyon, TMStadium and TMValley, shadows calculated in MP4.
Maniaplanet TitlePacks
You only need to download that TitlePack which you want to use:
If you want to setup a Maniaplanet Dedicated Server on where all above TitlePacks are mixed, then you need this TitlePack too (and of course all of the above):
- Trackmania2 (NOT YET AVAILABLE BY NADEO)
UASECO
Download the release UASECO/0.9.6 2019-03-02.
Uniform Server ZeroXIII @home
Download the latest release of the Uniform Server ZeroXIII at SourceForge
Preparing
Lets starting it
Personal Data
In order to setup a Maniaplanet Dedicated Server and UASECO you need the following:
- The
PlayerLogin
from the player - The
PlayerPassword
from the player - The
Validation Key
from the player - A valid e-mail-address
Networking
To make the foreign players able to connect to your Maniaplanet dedicated server, you have to open some ports in your firewall.
If you want to run the Maniaplanet Dedicated Server and UASECO on a computer that is located at your home, then you probably have a router over that this computer is connected to the internet. In this case you have to forward traffic at the listed ports below to the local IP of your computer on that the Maniaplanet dedicated server and UASECO are running on.
Required ports
- Server port
2350
UDP and TCP incomming and outgoing traffic - P2P port
3450
UDP and TCP incomming and outgoing traffic - HTTP port
80
and443
TCP and UDP incomming and outgoing traffic (mostly for the Maniaplanet Dedicated Server to communicate to the MasterServer) - HTTP port
8082
TCP incomming and outgoing traffic (to communicate to the Dedimania servers)
Do not open the XML-RPC port 5000 to the internet, because this is only for local communication between the Maniaplanet Dedicated Server and UASECO!
If you want to have more then one Maniaplanet Dedicated Server on one computer, then you have to increase the
Server
, P2P
and XML-RPC
port, e.g. to 2351
, 3451
and 5001
and so on.
Maniaplanet dedicated server account
You have to create a server account at your Maniaplanet Account Manager, login with your PlayerLogin
and PlayerPassword
.
Later we need the ServerLogin
and ServerPassword
of that server you have created.
To be able to receive Planets by donations from players or to pay out Planets by e.g. Records-Eyepiece for the ranks 1 till 3 after each map, you have to transfer an amount of Planets from your player account to the just created Maniaplanet Dedicated Server account.
Click on Edit
right from the just created Maniaplanet Dedicated Server account and then enter an amount of planets, I recommend an amount of 1000 Planets:
Dedimania registration
To be able to use the Dedimania plugin, you have to register your Maniaplanet Dedicated Server account at Dedimania to be able to read and store records from your players.
You have to authenticate you with your player login at dedimania.net
and to select Connect on ManiaPlanet - MP4
(see screenshot no. 1), after sucessfully authentication you have to click on Register your dedicated servers
(see screenshot no. 2).
On that page you will see all your dedicated servers you have registered in the player page at www.maniaplanet.com (see screenshot no. 3), click on the button
Register server
at that dedicated server you want to create the dedimania code to.
After that copy your dedimania code, you will need this later at the UASECO installation (see screenshot no. 4).
Create folder @home
Please create a folder on your harddrive, in this manual we use C:\ManiaplanetServer\
. In these folder
we will install the Maniaplanet Dedicated Server , UASECO and the Uniform Server ZeroXIII
- Create a subfolder in
C:\ManiaplanetServer\
with the nameGameServer
, then a pathC:\ManiaplanetServer\GameServer\
should exists now. - Create a subfolder in
C:\ManiaplanetServer\
with the nameuaseco
, then a pathC:\ManiaplanetServer\uaseco\
should exists now.
Extract Uniform Server ZeroXIII @home
- Create a subfolder in
C:\ManiaplanetServer\
with the nameUniformServerZeroXIII
, then a pathC:\ManiaplanetServer\UniformServerZeroXIII\
should exists now. - Execute the downloaded Uniform Server ZeroXIII file, e.g.
13_3_2_ZeroXIII.exe
and extract the files into the folderC:\ManiaplanetServer\UniformServerZeroXIII\
.
Setup Windows Command Prompt @home
To be able to see all of the output and read the most of the UTF-8 encoded Nicknames and Mapnames, you can setup the Windows Command Prompt. For a fully detailed manual and with screenshots visit https://www.isunshare.com/windows-8/change-font-font-size-and-layout-in-cmd.html
Prefered changes for an 1920 x 1080 px resolution:
- Change the font size to
14
or lower - Change the font to
Consolas
- Change the window size to width
220
and height60
PHP
Setup PHP
Edit php.ini
PHP normally use different ini-files for the API (e.g. CLI, Apache...), so you have to find which php.ini
your php-cli
is using.
You can simply find it by using the command php -r 'echo php_ini_loaded_file();'
in a console, that could output something like this: /etc/php/7.2.0/php-cli.ini
.
- Open
/etc/php/7.2.0/php-cli.ini
and search foropenssl.cafile
, if it is not found then addopenssl.cafile=/etc/php/7.2.0/cert.pem
to it, or does it not contain any value, then change it toopenssl.cafile=/etc/php/7.2.0/cert.pem
. - Move the downloaded
cert.pem
to/etc/php/7.2.0/cert.pem
.
You have to replace
/etc/php/7.2.0/
with the result of the command.
Edit C:\ManiaplanetServer\UniformServerZeroXIII\core\php72\php-cli.ini
@home
- Remove the beginning
;
from the following entries (if not already):- extension=php_ftp.dll
- extension=php_exif.dll
- extension=php_mysqli.dll
- extension=php_openssl.dll
- extension=php_gd2.dll
- extension=php_mbstring.dll
If an entry from the above list is missing, please add them.
- Add
openssl.cafile=C:\ManiaplanetServer\UniformServerZeroXIII\core\php72\cert.pem
to it. - Move the downloaded
cert.pem
toC:\ManiaplanetServer\UniformServerZeroXIII\core\php72\cert.pem
.
Dedicated Server
Installing the Maniaplanet Dedicated Server
reaby wrote a very detailed and good documentation on how to install the Maniaplanet dedicated server, which can be found at the official Maniaplanet forum. So if you get stuck somewhere in here, you can try to look for a solution there (and please let me know where you got stuck).
Extract the Maniaplanet Dedicated Server
Extract the file ManiaplanetServer_2019-02-27.zip
into the folder C:\ManiaplanetServer\GameServer\
.
Extract the file 2018-07-14_UserData.zip
into the folder C:\ManiaplanetServer\GameServer\
.
Contents of C:\ManiaplanetServer\GameServer\
GameData\
Packs\
RemoteControlExamples\
UserData\
ListCallbacks_2011-08-01.html
ListCallbacks_2011-10-06.html
ListCallbacks_2012-06-19.html
ListCallbacks_2013-04-16.html
ManiaPlanetServer
ManiaPlanetServer.exe
RunSrvSM.bat
RunSrvSM.sh
RunSrvTM.bat
RunSrvTM.sh
Setup MatchSettings
You have to setup the Maniaplanet Dedicated Server to run in the <game_mode>
"Script" and <script_name>
to TimeAttack.Script.txt
,
also you have to declare which <title>
the Maniaplanet Dedicated Server should use.
Copy C:\ManiaplanetServer\GameServer\UserData\Maps\MatchSettings\TMCanyonA.txt
to C:\ManiaplanetServer\GameServer\UserData\Maps\MatchSettings\maplist_canyon.txt
.
Edit C:\ManiaplanetServer\GameServer\UserData\Maps\MatchSettings\maplist_canyon.txt
with Notepad++:
<?xml version="1.0" encoding="utf-8" ?>
<playlist>
<gameinfos>
<game_mode>0</game_mode>
<script_name>TimeAttack.Script.txt</script_name>
<title>TMCanyon@nadeo</title>
</gameinfos>
</playlist>
The above example is shorter and only the required tags that need to be changed or added are shown.
Setup dedicated config
Copy C:\ManiaplanetServer\GameServer\UserData\UserData\Config\dedicated_cfg.default.txt
to C:\ManiaplanetServer\GameServer\UserData\Config\dedicated_canyon.txt
.
Edit C:\ManiaplanetServer\GameServer\UserData\Config\dedicated_canyon.txt
:
<dedicated>
<authorization_levels>
<level>
<name>SuperAdmin</name>
<password>YOUR_SUPERADMIN_PASSWORD</password>
</level>
<level>
<name>Admin</name>
<password>YOUR_ADMIN_PASSWORD</password>
</level>
<level>
<name>User</name>
<password>YOUR_USER_PASSWORD</password>
</level>
</authorization_levels>
<masterserver_account>
<login>YOUR_SERVER_LOGIN</login>
<password>YOUR_SERVER_PASSWORD</password>
<validation_key>YOUR_VALIDATION_KEY</validation_key>
</masterserver_account>
<server_options>
<name>YOUR_SERVER_NAME</name>
</server_options>
<system_config>
<connection_uploadrate>8000</connection_uploadrate>
<connection_downloadrate>8000</connection_downloadrate>
<server_port>2350</server_port>
<server_p2p_port>3450</server_p2p_port>
<xmlrpc_port>5001</xmlrpc_port>
<title>TMCanyon@nadeo</title>
<disable_coherence_checks>true</disable_coherence_checks>
</system_config>
</dedicated>
The above example is shorter and only the required tags that need to be changed or added are shown. For a detailed description of each tag visit the official documentation.
- Replace
YOUR_SUPERADMIN_PASSWORD
with a secure password for maximum security, do not re-use this! - Replace
YOUR_ADMIN_PASSWORD
with a secure password for maximum security, do not re-use this! - Replace
YOUR_USER_PASSWORD
with a secure password for maximum security, do not re-use this and do not use your password from your player login here! - Replace
YOUR_SERVER_LOGIN
with your setup at the PlayerPage. - Replace
YOUR_SERVER_PASSWORD
with your setup at the PlayerPage. - Replace
YOUR_VALIDATION_KEY
with your validation key you have received by mail after your Player account registration (usually five characters long). - Replace
YOUR_SERVER_NAME
with a name that describes your server, you can use formating codes and Crazy Nicknames to make your server unique. This name will be shown in the in-game serverlist. - You should setup
<connection_uploadrate>
and<connection_downloadrate>
to the values the internet connection can handle (Kbits per second). - The
<title>
has to be in sync with the settings fromC:\ManiaplanetServer\GameServer\UserData\Maps\MatchSettings\maplist_canyon.txt
. - You should
<disable_coherence_checks>
set totrue
to prevent players to be kicked and banned from the Maniaplanet Dedicated Server when the connection of the player is very slow.
I changed
<system_config><xmlrpc_port>
from5000
to5001
, because the game client reserves it for ingame lan server, so if you start the game client before the dedicated server, you get an error likenot in script mode
.
Setup startup file
I prefer to have a simple filename for the startup file for the Maniaplanet Dedicated Server, so I use the ServerLogin
as part of the filename.
With this you can see easily which Maniaplanet Dedicated Server it is.
Replace
YOUR_SERVER_LOGIN
with the<masterserver_account><login>
fromC:\ManiaplanetServer\GameServer\UserData\Config\dedicated_canyon.txt
.
Linux
Copy C:\ManiaplanetServer\GameServer\RunSrvTM.sh
to C:\ManiaplanetServer\GameServer\run_tm_YOUR_SERVER_LOGIN.sh
Edit C:\ManiaplanetServer\GameServer\run_tm_YOUR_SERVER_LOGIN.sh
:
#!/bin/sh
./ManiaPlanetServer /title=TMCanyon@nadeo /game_settings=MatchSettings/maplist_canyon.txt /dedicated_cfg=dedicated_canyon.txt
Windows @home
Copy C:\ManiaplanetServer\GameServer\RunSrvTM.bat
to C:\ManiaplanetServer\GameServer\run_tm_YOUR_SERVER_LOGIN.bat
Edit C:\ManiaplanetServer\GameServer\run_tm_YOUR_SERVER_LOGIN.bat
:
ManiaPlanetServer.exe /title=TMCanyon@nadeo /game_settings=MatchSettings/maplist_canyon.txt /dedicated_cfg=dedicated_canyon.txt
See the complete command line options and the official TitleIDs from the Maniaplanet Dedicated Server for more details.
- The parameter
/title
has to be the same as in theC:\ManiaplanetServer\GameServer\UserData\Maps\MatchSettings\maplist_canyon.txt
andC:\ManiaplanetServer\GameServer\UserData\Config\dedicated_canyon.txt
, so it isTMCanyon@nadeo
. - The parameter
/game_settings
has to be the MatchSettings file relative fromC:\ManiaplanetServer\GameServer\UserData\Maps\
, so it is justMatchSettings\maplist_canyon.txt
. - The parameter
/dedicated_cfg
has to be the filenameC:\ManiaplanetServer\GameServer\UserData\Config\dedicated_canyon.txt
, without the pathC:\ManiaplanetServer\GameServer\UserData\Config\
, so it is then justdedicated_canyon.txt
.
Cleanup
To save space on the drive (and to not transfer unnecessary you can remove the following files and folders from C:\ManiaplanetServer\GameServer\
:
RemoteControlExamples\
ListCallbacks_2011-08-01.html
ListCallbacks_2011-10-06.html
ListCallbacks_2012-06-19.html
ListCallbacks_2013-04-16.html
RunSrvSM.bat
RunSrvSM.sh
Linux
Delete the ManiaPlanetServer.exe
and RunSrvTM.bat
files too.
Windows @home
Delete the ManiaPlanetServer
and RunSrvTM.sh
files too.
UASECO
Installing the UASECO server controller
In this part of this documentation we install the server controller USAECO, this will store the informations for Records, Players, Maps and so on, and let you control several things at the dedicated Server.
Extract UASECO server controller
Extract the file UASECO-0.9.6-2019-03-02.zip
into the folder C:\ManiaplanetServer\uaseco\
.
Contents of C:\ManiaplanetServer\uaseco\
uaseco\cache\
uaseco\config\
uaseco\docs\
uaseco\includes\
uaseco\locales\
uaseco\logs\
uaseco\newinstall\
uaseco\plugins\
uaseco.php
Setup the Database
You have to create a database in MySQL or MariaDB in where UASECO can store informations, settings, records and so on. You can use phpMyAdmin for this, or connect directly to the MySQL console.
Connect to the MySQL console
mysql --user='root' -p
You will be asked for the password of root, after successfully authentication, create an new database.
Create an new database for UASECO:
CREATE DATABASE `uaseco` DEFAULT CHARACTER SET 'utf8mb4' DEFAULT COLLATE 'utf8mb4_unicode_ci';
You can use an other name as uaseco
for that database, but in this documentation I will use this name.
After that you have to create a seperate user and grant this user all rights to the uaseco
database:
Create an new User
CREATE USER 'MYSQL_USER'@'localhost';
SET PASSWORD FOR 'MYSQL_USER'@'MYSQL_HOST' = password('MYSQL_PASSWORD');
GRANT ALL PRIVILEGES ON `uaseco`.* TO 'MYSQL_USER'@'localhost' WITH GRANT OPTION;
- Replace
MYSQL_USER
with the mysql user you have created or you got from your provider. - Replace
MYSQL_HOST
with the hostname on which your MySQL or MariaDB server is running on, normally it islocalhost
. - Replace
MYSQL_PASSWORD
with a secure password.
Setup the database tables
Setting up the database tables in MySQL is done automatically the first time UASECO runs, so here is no need to setup it manually.
Convert a database from XAseco2
If you are switching from XAseco2 to UASECO, then you can use your current database to keep all records of the players. In the last section Starting you will find a manual to convert your database.
Setup UASECO
Now you have to setup several files in the config
folder, to make UASECO able to connect to the database and to the Maniaplanet Dedicated Server,
and to welcome your players on your server.
The below action is only for an new installation, if you want to upgrade your UASECO installation, please visit the Upgrade Guide!
- Move all files from
C:\ManiaplanetServer\uaseco\newinstall\config\
into the folderC:\ManiaplanetServer\uaseco\config\
- Move all files from
C:\ManiaplanetServer\uaseco\newinstall\locales\
into the folderC:\ManiaplanetServer\uaseco\locales\
- Move
C:\ManiaplanetServer\uaseco\newinstall\uaseco.sh\
into the folderC:\ManiaplanetServer\uaseco\
- Move
C:\ManiaplanetServer\uaseco\newinstall\webrequest.sh\
into the folderC:\ManiaplanetServer\uaseco\
- Move
C:\ManiaplanetServer\uaseco\newinstall\uaseco.bat\
into the folderC:\ManiaplanetServer\uaseco\
(@home
) - Move
C:\ManiaplanetServer\uaseco\newinstall\webrequest.bat\
into the folderC:\ManiaplanetServer\uaseco\
(@home
)
If the folder C:\ManiaplanetServer\uaseco\newinstall\dedicated-server\
does contain a folder which name matches the release date of the Maniaplanet Dedicated Server then
you have to copy all the files:
- Copy the contents of
C:\ManiaplanetServer\uaseco\newinstall\dedicated-server\RELEASE_DATE
into the folderC:\ManiaplanetServer\GameServer\UserData\Scripts\
and override all the files.
Replace
RELEASE_DATE
with the release date of the Maniaplanet Dedicated Server.
Edit config\UASECO.xml
<dedicated_server>
<login>SuperAdmin</login>
<password>YOUR_SUPERADMIN_PASSWORD</password>
<ip>127.0.0.1</ip>
<port>YOUR_DEDICATED_PORT</port>
<timeout>180</timeout>
</dedicated_server>
<masteradmins>
<tmlogin>YOUR_PLAYER_LOGIN</tmlogin>
</masteradmins>
<dbms>
<host>DATABASE_HOST</host>
<login>DATABASE_LOGIN</login>
<password>DATABASE_PASSWORD</password>
<database>DATABASE_NAME</database>
<table_prefix>uaseco_</table_prefix>
</dbms>
<dedicated_installation>PATH_TO_DEDICATED_SERVER</dedicated_installation>
<admin_contact>YOUR_MAIL_ADRESS</admin_contact>
<mapimages_path>MAP_IMAGES_PATH</mapimages_path>
- Replace
YOUR_DEDICATED_PORT
with your setup fromUserData\Config\dedicated_canyon.txt
at<system_config><xmlrpc_port>
. - Replace
YOUR_SUPERADMIN_PASSWORD
with your setup fromUserData\Config\dedicated_canyon.txt
at<authorization_levels><level><password>
from theSuperAdmin
. - Replace
YOUR_PLAYER_LOGIN
with your player login. You can add more then one MasterAdmins if you want, just duplicate this line. - Replace
DATABASE_LOGIN
with the mysql user for the databaseuaseco
you created above. - Replace
DATABASE_PASSWORD
this with the mysql password for the databaseuaseco
you have set above. - Replace
DATABASE_NAME
this with the mysql you set above (e.g.uaseco
). - Replace
PATH_TO_DEDICATED_SERVER
this with the full path in where the fileManiaPlanetServer
is located after you have uploaded it to your dedicated server. For@home
the path isC:\ManiaplanetServer\GameServer\
. - Replace
YOUR_MAIL_ADRESS
with a working mail address. - Replace
MAP_IMAGES_PATH
with an full path in where the images of the maps will be stored. Make sure yourHTTP Webserver
handles this folder.
Edit config\dedimania.xml
<masterserver_account>
<login>YOUR_DEDIMANIA_LOGIN</login>
<dedimaniacode>YOUR_DEDIMANIA_CODE</dedimaniacode>
</masterserver_account>
- Replace
YOUR_SERVER_LOGIN
with theServerLogin
. - Replace
YOUR_DEDIMANIA_CODE
with code you have created at Dedimania at the server registration.
Edit config\mania_karma.xml
<nation>YOUR_NATION</nation>
- Replace
YOUR_NATION
this with a ISO 3166 ALPHA-3 string which represents your nation, see a full list at WikiPedia at the row Alpha-3.
Edit config\records_eyepiece.xml
<features>
<maplist>
<mapimages>
<access_url>YOUR_MAP_IMAGES_FOLDER_URL</access_url>
</mapimages>
</maplist>
</features>
- Replace
YOUR_MAP_IMAGES_FOLDER_URL
with the full URL of the<mapimages_path>
folder, e.g.http://example.com/mapimages/
(you have setup this folder inconfig/UASECO.XML
at<mapimages_path>
).
These are the minimal settings, you can change more later, but lets have a running system first!
Edit newinstall\uaseco.sh and newinstall\webrequest.sh
- Replace
cd /home/tm2/uaseco
with the real path on your server.
Edit newinstall\uaseco.bat and newinstall\webrequest.bat (@home
)
- Replace
C:\Programme\Apache2\Php5
withC:\ManiaplanetServer\UniformServerZeroXIII\core\php71
.
Upload
Transfer the files
Upload files
Transfer all files and folders from C:\ManiaplanetServer\
into a folder by FTP or SCP to your dedicated server, e.g. /home/YOUR_USER/
Replace
YOUR_USER
with the correct user of your system.
Change rights
After uploading you have to change some rights, login by SSH on your dedicated server:
cd /home/YOUR_USER/
chmod 0700 GameServer/ManiaPlanetServer
chmod 0700 GameServer/run_tm_YOUR_SERVER_LOGIN.sh
chmod 0755 GameServer/UserData/Replays/GReplays/
chmod 0755 GameServer/UserData/Replays/VReplays/
chmod 0700 uaseco/uaseco.sh
chmod 0700 uaseco/webrequest.sh
Replace
YOUR_USER
with the correct user of your system andYOUR_SERVER_LOGIN
with theServerLogin
you have created at the setup of the Maniaplanet Dedicated Server.
Starting
Lets go into the hot phase
Connect to your dedicated server by SSH.
Convert an existing XAseco2 database
If you have a XAseco2 database and want to use them, you have to convert it into the UASECO database structure. For this just use the included converter:
cd /home/YOUR_USER/uaseco/
php -d max_execution_time=0 -d memory_limit=-1 newinstall/database/convert-xaseco2-to-uaseco.php
Replace
YOUR_USER
with the correct user of your system. You have to setup theconfig\UASECO.xml
first, because the settings for the database will be read from this file!
Start the Maniaplanet Dedicated Server
cd /home/YOUR_USER/GameServer/
./run_tm_YOUR_SERVER_LOGIN.sh
@home
cd C:\ManiaplanetServer\GameServer\
.\run_tm_YOUR_SERVER_LOGIN.bat
Start UASECO server controller
cd /home/YOUR_USER/uaseco/
./webrequest.sh
./uaseco.sh
@home
cd C:\ManiaplanetServer\uaseco\
.\webrequest.bat
.\uaseco.bat
This is a private enthusiast Website. Maniaplanet, Trackmania, Shootmania, Nadeo are trademarks of Ubisoft Entertainment.
Windows is a registered trademark of Microsoft Corporation.