Making a Server
Hosting a Manic Digger server is quite easy. However before getting started right away, there are a few things you should consider.
First get familiar with the server configuration. Although the default configuration is already sufficient, you should adjust it to best meet your needs in order to make your server individual. Come up with a good concept, create groups and divide the map into areas. This will attract more players and makes your server popular.
A Manic Digger server is really modest. It runs well on older hardware. A 1GHz CPU and 1 GB of RAM should be sufficient to run a 12 slot server at default configurations.
Traffic consumption of a Manic Digger Server keeps within bounds. A 12 slot server shouldn't consume more than 30 GB/month. However when hosting multiple player slots, make sure you have a broadband internet connection with sufficient bandwidth. For a server, in particular the upstream speed counts. Don't set player slot count too high, if you have a slow upstream rate. This is often the case at asymmetric connection technologies i.e. the widespread ADSL.
Of course you can run the server at the same machine you are running the client. However make sure, your PC is powerful enough to run both. A server can get quickly really laggy and unplayable if your PC is at high load. If you have the means, we recommend to run the server on a separate "dedicated" PC. Thus the server can use full hardware resources. If you want to host the server on dedicated Linux root server, have a look at here.
In the following you may need to access your network configuration in order to open a port required by the Manic Digger server.
A Manic Digger server requires an open port. Per default, it uses port 25565. The port can be changed in the server configuration file. The process of opening a port differs between router models. Thus we cannot give an instruction about that here. If you don't know how to do it, look at your router's manual or ask someone at your home who is familiar with networking. Players won't be able to join your server until the port is definitely reachable from outside although the server is listed in the server list. You can test here if the port is open. Furthermore make sure that your operating system's firewall doesn't block the server.
Choose a version
You have the choice between main and nightly version. Main version should be more stable and most players use this version. Nightly builds are preview development versions containing new features and bugfixes. For a server, the binary archive is recommended, not the installer. The advantage of this is, that an installation of Manic Digger is not required. You can quickly switch between version and run several servers in parallel. The versions can be found here.
Setting up server
The following assumes you are using the binary archive of a current version of Manic Digger. After downloading the binary archive of your choice you have the zip file ManicDigger<Date>Binary.zip.
- Unpack this archive and place the folder ManicDigger<Date>Binary to any directory. All game related files are located in this folder.
- Start ManicDiggerServer.exe. The server's text console appears. This shows the server's status information, debug messages and errors. Furthermore you can enter in this window any server command. Watch out for any error messages in this window. Your server is now running.
- Stop the server by closing the server window or by pressing CTRL+C. A new subfolder UserData has been created in your Manic Digger directory. This folder is being created when you start the server for the first time. It contains the required files by the server. The folder Saves contains the file default.mddbs. This is the server map in form of a SQLite3 database. The world is being stored there. Regularly backup this file.
- In the end, you need to configure the server - possibly the most important and hardest part. The configuration files are located in the folder Configuration in UserData. The main configuration is set in the file ServerConfig.txt. The default configuration does already a good job. However you should get familiar with configuration and adjust to best meet your needs.
Continue reading: server configuration.
Connecting to a server
You need first to make an account at manicdigger.sourceforge.net/play When the server is set to be public it is listed in the multiplayer server list. Given your port is accessible from outside you can connect with your account by clicking the appropriate line. If your server is behind a firewall, you need to be in the same home network and use a local IP address or server name in order to connect. If you use the "Connect to IP"-Button you can only log in as guest!
Best way is to log in a local server is to visit manicdigger.sourceforge.net/play, copy the link to your server (it looks like md://22.214.171.124:25565/?user=yourusername&auth=09abcdef1234567ab123ef123456688a) and replace the address (126.96.36.199 in the example) by your local IP address (if you don't know how to find out your IP address see this tutorial) or name of the computer that runs the server. You can use this link in a web browser to start ManicDigger and connect to your server with your account. Alternatively, you can make a Shortcut on Windows desktop, start menu or in a Windows folder. Right click, select "add shortcut" and add md://mycomp:25565/?user=yourusername&auth=09abcdef1234567ab123ef123456688a (with your respective data) as target.
Using this shortcut directly connects your player to the selected server.
Instruction for configuring a server with version 2011-05-04s or older release: Making a Server (2011-02-12)