HowTo: Modded Minecraft Server with ATLauncher
In this article I'll show you how to set up a custom minecraft server for any mod pack that's available in the ATLauncher mod package (on Linux). For this and also what's running on the minecraft server for my friends and me it's going to be DNSTechPack.
I'm going to use Digital Ocean for showing how to set up the dedicated and modded Minecraft Server from scratch. Using my referral link you'll get 10$ to start out with, which covers a month with a 1GB server with them. Another great host for your VPS would be Linode!
I rarely blog about gaming, since also most of all these things are covered over at unganked.com, but this I thought also related to Linux server administration in general.
[Client]: Getting the ATLauncher
To get the ATLauncher, you just have to head to the ATLauncher website and pick a pack to install. You'll have to log in to your Minecraft account for this, only on your client, not the server.[Server]: Getting a Server
Once I've set up a new virtual server with a recent Ubuntu version on Digital Ocean, we can get started and log in to our server through SSH.If you're on Windows I can recommend Putty, if you're on Mac OS or Linux in the first place, you can start your respective Terminal and type: ssh root@IP where IP represents the IP address of your freshly created server.
Technically you should not run servers as the root user, but as another user with lower privileges, so you avoid giving an attacker root permissions if your service is compromised. I'll skip this part for now, but you can add other users through the useradd command on the server. If you want to know more about this, just type man useradd into a Linux shell.
[Server]: Installing the ATLauncher Modpack
Using the search function on the atlauncher website, you can easily find the server download on the page of the respective modpack. You'll be provided a .zip file with a name that includes mod pack name and version, like this:DNSTechpack - 7.7.1.2.zip.
An example of this can be found here: https://www.atlauncher.com/pack/DNSTechpack/
You can unpack it to see how it looks, but I would recommend uploading the .zip file, because it's significantly faster to upload one file through scp/sftp compared to hundreds when it's extracted.
To upload the file/files to your server, you can use an FTP/SFTP client like Filezilla or Cyberduck. After uploading to the server, we have to use our SSH client of choice to log into the server with ssh root@IP, root should be replaced by your username, IP with the IP of your server (in case you're not doing it locally).
To install the java dependencies, you can run:
sudo apt-get update
sudo apt-get install default-jre
# optional: sudo apt-get install openjdk-7-jre
Firstly now we'll create a separate directory for the modpack server and afterwards move the .zip file into it and extract it:
mkdir minecraft-server
mv DNSTechpack\ -\ 7.7.1.2.zip minecraft-server
cd minecraf-server
unzip DNSTechpack\ -\ 7.7.1.2.zip
Now the directory you're in should look like this:
config libraries options.txt scripts
DNSTechpack - 7.7.1.2.zip liteconfig pack.json SetupServer.jar
forge-1.7.10-10.13.4.1481-1.7.10-universal.jar mods resources
Next, we'll run the SetupServer.jar with the following command: java -jar SetupServer.jar, which will download the correct vanilla Minecraft server version for the modpack. The console output was:
No graphics environment detected, so running command line only!
Setting up the server!
Downloading http://s3.amazonaws.com/Minecraft.Download/versions/1.7.10/minecraft_server.1.7.10.jar to /home/geronimo/Downloads/mc-server-tut/minecraft_server.1.7.10.jar
Server has now been setup! You can now run forge-1.7.10-10.13.4.1481-1.7.10-universal.jar to start the server or alternatively use the LaunchServer script!
Afterwards these should be the contents of your directory:
config
DNSTechpack - 7.7.1.2.zip
forge-1.7.10-10.13.4.1481-1.7.10-universal.jar
LaunchServer.bat
LaunchServer.sh
libraries
liteconfig
minecraft_server.1.7.10.jar
mods
options.txt
pack.json
resources
scripts
SetupServer.jar
To run your server, you can now run the LaunchServer.sh. Firstly we will make sure the file is executable.
chmod +x LauncherServer.sh
./LaunchServer.sh
Depending on the speed of your server, this might take up to a whopping 10 minutes. Since this is the first time we run server, we will get an error message, but the essential part is NOT in the last lines of it.
[20:24:13] [Server thread/WARN]: Failed to load eula.txt
[20:24:13] [Server thread/INFO]: You need to agree to the EULA in order to run the server. Go to eula.txt for more info.
[20:24:13] [Server thread/WARN] [FML]: Can't revert to frozen GameData state without freezing first.
[20:24:13] [Server thread/INFO] [FML]: Applying holder lookups
[20:24:13] [Server thread/INFO] [FML]: Holder lookups applied
[20:24:13] [Server thread/WARN] [EnderIO]: Failed to write Transciever Channels on exit: java.util.concurrent.ExecutionException: java.lang.NullPointerException
[20:24:13] [Server thread/ERROR] [HatStand]: Skipping event FMLServerStoppedEvent and marking errored mod HatStand since required dependency Hats has errored
[20:24:13] [Server thread/INFO] [mcjty.rftools.RFTools]: RFTools: server is stopping. Shutting down gracefully
[20:24:13] [Server thread/INFO] [FML]: The state engine was in incorrect state ERRORED and forced into state SERVER_STOPPED. Errors may have been discarded.
[20:24:13] [Server thread/INFO] [FML]: The state engine was in incorrect state ERRORED and forced into state AVAILABLE. Errors may have been discarded.
It fails because it could not load the correct eula.txt, which we fix by opening it in a text editor. If you're on an ssh connection, I would recommend nano or vim. Alternatively, you can also download, edit and upload it again. You will need to change the eula from:
#By changing the setting below to TRUE you are indicating your agreement to our EULA (https://account.mojang.com/documents/minecraft_eula).
#Sun Aug 30 20:24:13 CEST 2015
eula=false
to eula=true. Now we can start the server again. Again, expect this to take a while.
You know it's done when you see the following lines in your terminal:
[20:37:28] [Server thread/INFO]: Preparing spawn area: 53%
[20:37:29] [Server thread/INFO]: Preparing spawn area: 62%
[20:37:30] [Server thread/INFO]: Preparing spawn area: 72%
[20:37:32] [Server thread/INFO]: Preparing spawn area: 80%
[20:37:33] [Server thread/INFO]: Preparing spawn area: 91%
[20:37:33] [Server thread/INFO]: Done (20.079s)! For help, type "help" or "?"
[Server] Tweaking the Launcher.sh
The default memory sizes in theLauncherServer.sh file are not optimal, so you might want to play around with that and tweak it a little, here's mine:
java -Xmx3500M -XX:MaxPermSize=3500M -jar forge-1.7.10-10.13.4.1481-1.7.10-universal.jar nogui -Dfml.queryResult=confirm
Dfml.queryResult=confirm means that you will automatically confirm any questions on startup and let forge take care of it. This could damage your world, use with caution!
[Server] Keeping it Running with Screen
To make sure your server keeps running after you quit the connection through ssh, I would recommend screen. You can start a screen session, by simply typingscreen after you have installed that with apt-get install screen.
Afterwards, you navigate to the location of your LauncherServer.sh and run it with ./LaunchServer.sh. Now you can press the combination: CTRL+A+D to background it, type exit and you've terminated your SSH connection, but the minecraft server still runs.
To resume your screen session, simply type: screen -r after reconnecting and you're right in the minecraft server again.
[Server] Managing white lists
To only allow certain players on your server, you can enable it by finding yourserver.properties file and setting the white-list option to true.
Afterwards, from within the server shell you add the individual users through whitelist add playername.
I would recommend whitelisting for every server that wants to avoid random players joining, that technically could just destroy your world or loot your treasures.
Summary
In this article I've thrown around with program names and ways to make this work, truth be told, there are many different ways to make your server work for you! If you have some great ideas, setups or experiences, let me know in the comments! If you have a question, post it as well, if I know, I will answer!