[Linux VPS] Setting Up a Lithium-Based MapleStory Server on a Linux VPS v111+

Indigoz · Apr 17, 2013

Wrriten by Indigo of ShadyGamer.com
Please do not re-release this guide elsewhere without proper credits and permission by me

This is not 100% complete, I will be adding pictures/screenshots soon

Indigoz - [Linux VPS] Setting Up a Lithium-Based MapleStory Server on a Linux VPS v111+ - RaGEZONE Forums

Downloads
(Download + Install them all)

To set up a MapleStory private server on a Linus VPS you will need the following on your own PC (NOT the VPS):

- Your Linux VPS (Obviously)
- Putty (

You must be registered to see links

)
- WinSCP [Not necessary but strongly recommended] (

You must be registered to see links

)
- Lithium [I'm going to be using v111 rev 96] (

You must be registered to see links

)
- Netbeans IDE (

You must be registered to see links

)
If you don't have Java, you'll need it for netbeans. Might as well get it now.
- MapleStory Localhost (

You must be registered to see links

v111)
- MapleStory v111 (

You must be registered to see links

)

Server Setup Step 1 - JAVA
First, open putty.exe and login with your VPS information. Enter your IP, username, and password accordingly.

The first step is to get java set up. My guide will be based off the CentOS distro, if you are using something else like Ubuntu, this will still work but you'll have to google some commands if you don't know them.

To download JDK 7, run the command

Code:

wget -p jdktmp/ --no-cookies --header "Cookie: gpw_e24=http://www.oracle.com" "http://download.oracle.com/otn-pub/java/jdk/7u17-b02/jdk-7u17-linux-x64.rpm"

Then to install it, run

Code:

rpm - Uvh /jdktmp/jdk-7u17-linux-x64.rpm

Now we need JRE 7, run the command

Code:

wget  http://javadl.sun.com/webapps/download/AutoDL?BundleId=75252

Code:

tar zxvf jre-7u17-linux-x64.tar.gz

Note: You may certainly change the download links in the codes above if you are using 32-bit, want a different file type, or for any other reason!
If for whatever reason you can't get the commands to work, you can download the appropriate linux file on your PC, transfer it to the VPS using WinSCP, and then install it from there.

Now run the command

Code:

ls

You should have two directories, one for JDK and one for JRE. Now we must copy these JCE files

You must be registered to see links

into our VPS. I recommended using WinSCP rather than the command line for moving these small files - just log in using your IP, username, and password. You'll be able to easily transfer the JCE files to these directories:

Code:

[COLOR=#141414]root\jre7\lib\security[/COLOR]
[COLOR=#141414]root\jre7\lib\ext[/COLOR]
[COLOR=#141414]root\jre7\lib[/COLOR]
[COLOR=#141414]root\jdk1.7\jre\lib[/COLOR]
[COLOR=#141414]root\jdk1.7\jre\lib\ext[/COLOR]
[COLOR=#141414]root\jdk1.7\jre\lib\security[/COLOR]

Now we have Java set up properly.

Server Setup Step 2 - MYSQL + REPACK
Now we have to get MySQL as our database. I use this command for downloading and installing it

Code:

yum install mysql mysql-server

To start MySQL for the first time, run

Code:

/etc/init.d/mysqld start

Now set your username (preferably root) and password (whatever you want)

Code:

mysqladmin -u root -p ShadyStoryIsFreakingAwesome

Open up MySQL

Code:

mysql - u root -p

Enter your password.

Now transfer the lithium repack that you downloaded into your VPS using WinSCP. I like renaming the source folder from "trunk" to something like "Source" or "ShadyStory", but it's up to you.

Now we have to execute all the SQL files. Go back into MySQL and use the source command to do so. For example,

Code:

source /root/Source/SQL/1 - Structure.sql

Do this for all the SQL files in your repack.

Now open up db.properties and replace it with

Code:

[COLOR=#141414]url=jdbc:mysql://localhost:3306/Lithium?autoReconnect=true[/COLOR]
[COLOR=#141414]user = root[/COLOR]
[COLOR=#141414]password = ShadyIsANoobcake[/COLOR]

Open worldGMS.properties and edit 127.0.0.1 to your VPS IP.
Under src/Constants/Serverconstants.jar find

Code:

public static final byte[] Gateway_IP = new byte[]{(byte) 127, (byte) 0, (byte) 0, (byte) 1};

and replace the 127, 0, 0, and 1 with your VPS IP. For example,

Code:

(byte) 205, (byte) 12, (byte) 613, (byte) 500

Also, change the MySQL password from "root" to whatever yours is. Hopefully not Shadyisanoobcake.

Under src/Database/Databaseconnection.java find "serverconstants"
Replace the "v111" above it to "Lithium".

Server Setup Step 3 - NETBEANS
Open up NetBeans IDE.

Go to File > New Project > Java Project with Existing Sources
Name it Lithium and choose your build folder. Remember it!
Then click next.

Under Source Package Folders, click "Browse". Then go to your repack and import the entire src folder.
Hit finish.

Now on the left hand side of Netbeans, click the '+' icon next to Lithium. Right click "Libraries" and click "Add JAR/Folder". Import all the .jar files in your source's dist folder.
Now go to run > Build Project (or just hit F11) and wait for it compile. Once it's done, find the Lithium.jar under your build folder destination that you selected in Netbeans. Copy that into your dist folder, and also copy it into your dist folder in the VPS.

Server Setup Step 4 - Shell Files
This step is fairly simple. It's very easy to convert .bat to .sh, but if you're lazy, just download these shell files

You must be registered to see links

(Kudos to Vintage of RageZone for sharing!)
Now edit them with NotePad and change the aerolith.jar on all three shell files to Lithium.jar

Now dump them all by running them one at a time. For example:
First go to your source folder

Code:

cd Source

Then make the shell script an executable

Code:

chmod u+rwx dump-items.sh

Finally execute it.

Code:

./dumpitems.sh

Do this for all three shell scripts.

Server Setup Step 5 - LocalHost, Portfowarding, Launching
You now need to download something to edit your localhost - STREDIT is what is now popular.
Link:

You must be registered to see links

Now open up Stredit and do File > Open > Find your v111 localhost that you downloaded.
In the bottom right, edit the IP 127.0.0.1 to your VPS IP. I also recommend forcing the use of just 1 IP.
Save it as the name of your server (ex. ShadyStory.exe) and place it inside your MapleStory v111 folder.

Go back to putty, and run the launch.sh

Code:

cd Source

Code:

./launch.sh

If your ports aren't forwarded, go ahead and forward them. You will need to follow the following ports

8484
8585
8587
8600
80 (It should be forwarded already)

Use this command to forward. (Change 8587 to whatever you need)

Code:

iptables -I INPUT 5 -p tcp -m tcp --dport 8587 -j ACCEPT

Congratulations, your server is now up! You can run the localhost client to get in-game.
Good luck!

Please let me know if there's anything wrong with my tutorial or if you're having and questions/problems and I'll try to help you.
Likes/Comments/Feedback are appreciated!

Brown Potatos · May 18, 2013

Indigoz said:
Wrriten by Indigo of ShadyGamer.com
Please do not re-release this guide elsewhere without proper credits and permission by me

This is not 100% complete, I will be adding pictures/screenshots soon

Downloads
(Download + Install them all)

To set up a MapleStory private server on a Linus VPS you will need the following on your own PC (NOT the VPS):

- Your Linux VPS (Obviously)
- Putty (
You must be registered to see links
)
- WinSCP [Not necessary but strongly recommended] (
You must be registered to see links
)
- Lithium [I'm going to be using v111 rev 96] (
You must be registered to see links
)
- Netbeans IDE (
You must be registered to see links
)
If you don't have Java, you'll need it for netbeans. Might as well get it now.
- MapleStory Localhost (
You must be registered to see links
v111)
- MapleStory v111 (
You must be registered to see links
)

Server Setup Step 1 - JAVA
First, open putty.exe and login with your VPS information. Enter your IP, username, and password accordingly.

The first step is to get java set up. My guide will be based off the CentOS distro, if you are using something else like Ubuntu, this will still work but you'll have to google some commands if you don't know them.

To download JDK 7, run the command

Code:

wget -p jdktmp/ --no-cookies --header "Cookie: gpw_e24=http://www.oracle.com" "http://download.oracle.com/otn-pub/java/jdk/7u17-b02/jdk-7u17-linux-x64.rpm"

Then to install it, run

Code:

rpm - Uvh /jdktmp/jdk-7u17-linux-x64.rpm

Now we need JRE 7, run the command

Code:

wget http://javadl.sun.com/webapps/download/AutoDL?BundleId=75252

Code:

tar zxvf jre-7u17-linux-x64.tar.gz

Note: You may certainly change the download links in the codes above if you are using 32-bit, want a different file type, or for any other reason!
If for whatever reason you can't get the commands to work, you can download the appropriate linux file on your PC, transfer it to the VPS using WinSCP, and then install it from there.

Now run the command

Code:

ls

You should have two directories, one for JDK and one for JRE. Now we must copy these JCE files

You must be registered to see links

into our VPS. I recommended using WinSCP rather than the command line for moving these small files - just log in using your IP, username, and password. You'll be able to easily transfer the JCE files to these directories:

Code:

[COLOR=#141414]root\jre7\lib\security[/COLOR] [COLOR=#141414]root\jre7\lib\ext[/COLOR] [COLOR=#141414]root\jre7\lib[/COLOR] [COLOR=#141414]root\jdk1.7\jre\lib[/COLOR] [COLOR=#141414]root\jdk1.7\jre\lib\ext[/COLOR] [COLOR=#141414]root\jdk1.7\jre\lib\security[/COLOR]

Now we have Java set up properly.

Server Setup Step 2 - MYSQL + REPACK
Now we have to get MySQL as our database. I use this command for downloading and installing it

Code:

yum install mysql mysql-server

To start MySQL for the first time, run

Code:

/etc/init.d/mysqld start

Now set your username (preferably root) and password (whatever you want)

Code:

mysqladmin -u root -p ShadyStoryIsFreakingAwesome

Open up MySQL

Code:

mysql - u root -p

Enter your password.

Now transfer the lithium repack that you downloaded into your VPS using WinSCP. I like renaming the source folder from "trunk" to something like "Source" or "ShadyStory", but it's up to you.

Now we have to execute all the SQL files. Go back into MySQL and use the source command to do so. For example,

Code:

source /root/Source/SQL/1 - Structure.sql

Do this for all the SQL files in your repack.

Now open up db.properties and replace it with

Code:

[COLOR=#141414]url=jdbc:mysql://localhost:3306/Lithium?autoReconnect=true[/COLOR] [COLOR=#141414]user = root[/COLOR] [COLOR=#141414]password = ShadyIsANoobcake[/COLOR]

Open worldGMS.properties and edit 127.0.0.1 to your VPS IP.
Under src/Constants/Serverconstants.jar find

Code:

public static final byte[] Gateway_IP = new byte[]{(byte) 127, (byte) 0, (byte) 0, (byte) 1};

and replace the 127, 0, 0, and 1 with your VPS IP. For example,

Code:

(byte) 205, (byte) 12, (byte) 613, (byte) 500

Also, change the MySQL password from "root" to whatever yours is. Hopefully not Shadyisanoobcake.

Under src/Database/Databaseconnection.java find "serverconstants"
Replace the "v111" above it to "Lithium".

Server Setup Step 3 - NETBEANS
Open up NetBeans IDE.

Go to File > New Project > Java Project with Existing Sources
Name it Lithium and choose your build folder. Remember it!
Then click next.

Under Source Package Folders, click "Browse". Then go to your repack and import the entire src folder.
Hit finish.

Now on the left hand side of Netbeans, click the '+' icon next to Lithium. Right click "Libraries" and click "Add JAR/Folder". Import all the .jar files in your source's dist folder.
Now go to run > Build Project (or just hit F11) and wait for it compile. Once it's done, find the Lithium.jar under your build folder destination that you selected in Netbeans. Copy that into your dist folder, and also copy it into your dist folder in the VPS.

Server Setup Step 4 - Shell Files
This step is fairly simple. It's very easy to convert .bat to .sh, but if you're lazy, just download these shell files

You must be registered to see links

(Kudos to Vintage of RageZone for sharing!)
Now edit them with NotePad and change the aerolith.jar on all three shell files to Lithium.jar

Now dump them all by running them one at a time. For example:
First go to your source folder

Code:

cd Source

Then make the shell script an executable

Code:

chmod u+rwx dump-items.sh

Finally execute it.

Code:

./dumpitems.sh

Do this for all three shell scripts.

Server Setup Step 5 - LocalHost, Portfowarding, Launching
You now need to download something to edit your localhost - STREDIT is what is now popular.
Link:
You must be registered to see links

Now open up Stredit and do File > Open > Find your v111 localhost that you downloaded.
In the bottom right, edit the IP 127.0.0.1 to your VPS IP. I also recommend forcing the use of just 1 IP.
Save it as the name of your server (ex. ShadyStory.exe) and place it inside your MapleStory v111 folder.

Go back to putty, and run the launch.sh

Code:

cd Source

Code:

./launch.sh

If your ports aren't forwarded, go ahead and forward them. You will need to follow the following ports

Use this command to forward. (Change 8587 to whatever you need)

Code:

iptables -I INPUT 5 -p tcp -m tcp --dport 8587 -j ACCEPT

Congratulations, your server is now up! You can run the localhost client to get in-game.
Good luck!

Please let me know if there's anything wrong with my tutorial or if you're having and questions/problems and I'll try to help you.
Likes/Comments/Feedback are appreciated!

Can't download Java using the commands
running OSCent 5.8

enanu · May 22, 2013

how can get a Linux VPS???

Liv3 · May 22, 2013

enanu said:
how can get a Linux VPS???

You buy one. What else?

royalmonky · May 23, 2013

Brown Potatos said:
Can't download Java using the commands
running OSCent 5.8

Just use wget on the download link... It aint that hard.

Indigoz · May 24, 2013

Brown Potatos said:
Can't download Java using the commands
running OSCent 5.8

wget --no-cookies --header "Cookie: gpw_e24=http://www.oracle.com%2Ftechnetwork%2Fjava%2Fjavase%2Fdownloads%2Fjdk-7u17-download-1501626.html;" PUT DOWNLOAD LINK HERE --no-check-certificate

royalmonky said:
Just use wget on the download link... It aint that hard.

It can be tricky if you're trying to wget from oracle's website

You must be registered to see links

matteram · Jul 10, 2013

I start server and get this error

please somebody help me

Mapleson · Aug 16, 2013

Could I do this tut witha FrostyMS v83 (linux source)? Or is this v1.11 only?

abbychase · Aug 17, 2013

I87HjgZ - [Linux VPS] Setting Up a Lithium-Based MapleStory Server on a Linux VPS v111+ - RaGEZONE Forums

Any help?

mrflame · Oct 18, 2013

Did everything you said but maple didn't load and gave me the "Cannot connect to Login Server" in a windows box with Yes or No option.. Help?

HeartLess · Oct 26, 2013

This guide is missing a lot of stuff. I set a server up for fun and got it working, but if you're following this guide step-by-step, it's not going to work. You need to figure out several more things on your own.

GoTSkillzInIT · Jun 6, 2015

Sorry for the bumping of an old thread but this would really help me if only the commands were ubuntu .. Can anyone help me?

iwtLive · Jun 8, 2015

Will this have a better performance than windows 8 2012 R2?

lorend120 · Jul 14, 2015

do you have a toturial how to install a v62 (or another old version) on linux?

Hippalectryon · Jul 19, 2017

can someone reupload the shell files or convert this one to a shell from bat for me please?

Code:

@echo off@title Lithium Server Consoleset CLASSPATH=.;dist\Lithium.jar;dist\mina-core.jar;dist\slf4j-api.jar;dist\slf4j-jdk14.jar;dist\mysql-connector-java-bin.jarjava -server -Dnet.sf.odinms.wzpath=D:\XMLWZs\GMSv111\ server.Startpause

Welcome!

[Linux VPS] Setting Up a Lithium-Based MapleStory Server on a Linux VPS v111+

Indigoz

Newbie Spellweaver

Brown Potatos

Newbie Spellweaver

enanu

Newbie Spellweaver

Liv3

Mythic Archon

royalmonky

Elite Diviner

Indigoz

Newbie Spellweaver

matteram

Newbie Spellweaver

Mapleson

Initiate Mage

abbychase

Initiate Mage

Attachments

mrflame

Newbie Spellweaver

HeartLess

Initiate Mage

GoTSkillzInIT

Newbie Spellweaver

iwtLive

Experienced Elementalist

lorend120

Newbie Spellweaver

Hippalectryon

Newbie Spellweaver

About Us

Online statistics

Forum statistics

RaGEZONE Sponsor