Massgate is the online backend server for the Massive Entertainment game World in Conflict, and is now open-source to make it possible for anyone to host their own Massgate server.
Switch branches/tags
Nothing to show
Clone or download

README.md

World in Conflict Massgate

Introduction

Massgate is the central server for the Massive Entertainment game World in Conflict that manages the online functionality such as keeping track of dedicated game servers, user accounts, clans, ladders etc. The original game was released in 2007, and the official Massgate server was shutdown in 2016. To make it possible to continue to play World in Conflict online the source code of Massgate is now open source, making it possible for anyone to host their own Massgate server.

The code itself is more or less the same as how the code looked like back when the game is released. Only minor tweaks have been made to make it build on a relative modern compiler and to remove the necessity to manage CD-keys. Not much of the code has survived into later releases done by Massive Entertainment and does not really reflect to code of the company today, apart from the code standard and the general look and feel of the code. As a piece of game development history, and for anyone interested in how online servers were written at the time, it can definitely be a point of interest.

Dependencies

Massgate depends on MySQL, and it was built with MySQL version 4.2.1 which is an ancient version today and is 32bit. Massgate has been briefly tested with a newer version of MySQL, but there are no guarantees that it will work flawlessly.

The game also depends on a web server running to get information about the latest patches for the game. Any web server will do, more details below.

Building Massgate

To build Massgate you need CMake and some version of Visual Studio. At the moment only Visual Studio 2015 has been tested.

Point CMake to the root folder of the source to configure and generate a solution. The solution will end up in the build folder.

Running Massgate

MySQL

In order to run Massgate, you need a MySQL server it can connect to and a database prepared with data and tables. The commands to create them can be found in the SQL file under the share/sql folder.

To set up MySQL on localhost using the command line tool would look something like this:

mysql> create database live;
mysql> use live;
Database changed
mysql> grant all on live.* to 'massgateadmin'@'localhost' identified by 'adminpassword';
Query OK, 0 rows affected (0.00 sec)

mysql> grant all on live.* to 'massgateclient'@'localhost' identified by 'clientpassword';
Query OK, 0 rows affected (0.00 sec)

mysql> source share/sql/databasestructure.sql

In order for Massgate to be able to connect to the database, the hosts writedb.massgate.local and readdb.massgate.local need to point to the database. An easy way of achiving that locally in Windows is to edit the Windows hosts file under C:\Windows\System32\drivers\etc\hosts by adding the following lines:

127.0.0.1 writedb.massgate.local
127.0.0.1 readdb.massgate.local

Start Massgate

To start Massgate, you need to run the MMassgateServers.exe found in the build/bin folder with the following arguments:

MMassgateServers.exe live -noboom -all -dbname live -massgateport 3001 -logsql

But before you run the executable, make sure config.ini is present int the working directory of the executable.

If everything is okay you should see something like this in the a console window:

2015-09-08 12:24:13 [2532] [INFO  ]  : Creating 16 handler threads (8 per core,
max 16).
2015-09-08 12:24:13 [2532] [INFO  ]  : Kickstarting server.
2015-09-08 12:24:13 [2532] [INFO  ]  : Server startup sequence OK.

Running a Web Server

World in Conflict needs to connect to a web server in order to get information about patches. Any simple web server that points to the share/www-root folder should work.

An easy way to run a web server is to simply use Python and start a server like this:

cd share\www-root
python -m SimpleHTTPServer 80

Running a Dedicated Game Server

The dedicated game server is called Wic_ds.exe and is included in the distribution of the game. It is installed by Uplay upon download.

To redirect the executable to a locally hosted Massgate server (running Massagate and the database) host names need to be redirected.

In the Windows hosts file under C:\Windows\System32\drivers\etc\hosts add the following lines:

127.0.0.1 liveaccount.massgate.net
127.0.0.1 liveaccountbackup.massgate.net
127.0.0.1 stats.massgate.net
127.0.0.1 www.massgate.net  

In order for the dedicated game server to connect to Massgate, make sure the Wic_ds.ini is set to report to Massgate.

[ReportToMassgate] 
1

Connect With the Game

To make the game connect to Massgate you need to redirect host names on the machine the game is running on as well. In the Windows hosts file under C:\Windows\System32\drivers\etc\hosts add the following lines:

127.0.0.1 liveaccount.massgate.net
127.0.0.1 liveaccountbackup.massgate.net
127.0.0.1 stats.massgate.net
127.0.0.1 www.massgate.net  

Contributing

The code is shared as is. Anyone is free to fork the code and do whathever they want as long as the licences are respected. We will generally not accept pull requests as the source is shared to let the community take over and continue with Massgate.

If there is a major issue with the codebase that should apply to any version of it we will consider such a request.

Suggestions For Possible Improvemets

Adding support for more databases, such as Sqllite or PostgreSQL, could ease setup and hosting of Massgate. If you are interested take a look at the MDatabase library.

There is also the possibility to recreate, or make a new modern improved Massgate web portal by using the data found in the database. The original portal (not included in this repo) did just that.