How to setup a private server using the OdinMS source
The Java Runtime Environment (Version 6)
Choose Java SE 6 Update 10 Beta.
Choose the JDK, not the JRE.
The JCE Unlimited Strength Files
Go to the bottom, the link is under "Other Downloads"
Apache MINA 1.1
MySQL Connector/J
slf4j 1.5
MySQL
MySQL Query Browser
Installation
1. Download and extract the OdinMS source code from Sourceforge. If you don't know which one to download, get the odinms-0.5.zip one.
2. Download and install MySQL. Choose all the default settings and remember what password you set. If you don't know what you're doing, just set your password to "root"
3. Install MySQL Query Browser (GUI Tools). Use it to connect to mysql (the username is "root" unless you changed it and the password is the one you set in step 2). Choose "odinms" as your default schema.
4. In the Query Browser create a new schema (right click>Create New Schema) called "odinms"
5. Double click on odinms and go File>Open Script. Browse to odinms.sql in the source code directory and open it. The code will load. Click Execute in the top right and wait for the script to execute.
6. Locate the following files from the "Apache MINA," "MySQL Connector," and "slf4j 1.5" download, and copy the following files from them to the /dist folder in the odinms source directory:
Code:
mina-core-1.1.7.jar
slf4j-api-1.5.0.jar
slf4j-jdk14-1.5.0.jar
mysql-connector-java-3.1.14-bin.jar
7. Rename those files as follows:
Code:
mina-core-1.1.7.jar to mina-core.jar
slf4j-api-1.5.0.jar to slf4j-api.jar
slf4j-jdk14-1.5.0.jar to slf4j-jdk14.jar
mysql-connector-java-3.1.14-bin.jar to mysql-connector-java-bin.jar
8. Open launch_world.bat, launch_login.bat, and launch_channel.bat in notepad and change the CLASSPATH line to say this:
Code:
set CLASSPATH=.;dist\odinms.jar;dist\mina-core.jar;dist\slf4j-api.jar;dist\slf4j-jdk14.jar;dist\mysql-connector-java-bin.jar
9. Go to the folder with your OdinMS source. Open the file "db.properties" and change the bottom two lines to say "user = root" and "password = root" (but change the password to whatever you set it as in step 2). Also change the "DBNAME" in the url line to "odinms"
10. Open launch_world.bat, launch_login.bat, and launch_channel.bat in notepad and change the third line (the one that starts with "Java") to these:
launch_world.bat
Code:
java -Dnet.sf.odinms.recvops=recvops.properties -Dnet.sf.odinms.sendops=sendops.properties -Dnet.sf.odinms.wzpath=wz\ -Djavax.net.ssl.keyStore=key.keystore -Djavax.net.ssl.keyStorePassword=passwd -Djavax.net.ssl.trustStore=key.keystore -Djavax.net.ssl.trustStorePassword=passwd net.sf.odinms.net.world.WorldServer
launch_login.bat
Code:
java -Dnet.sf.odinms.recvops=recvops.properties -Dnet.sf.odinms.sendops=sendops.properties -Dnet.sf.odinms.wzpath=wz\ -Dnet.sf.odinms.login.config=login.properties -Djavax.net.ssl.keyStore=key.keystore -Djavax.net.ssl.keyStorePassword=passwd -Djavax.net.ssl.trustStore=key.keystore -Djavax.net.ssl.trustStorePassword=passwd net.sf.odinms.net.login.LoginServer
launch_channel.bat
Code:
java -Dnet.sf.odinms.recvops=recvops.properties -Dnet.sf.odinms.sendops=sendops.properties -Dnet.sf.odinms.wzpath=wz\ -Dnet.sf.odinms.channel.config=channel.properties -Djavax.net.ssl.keyStore=key.keystore -Djavax.net.ssl.keyStorePassword=passwd -Djavax.net.ssl.trustStore=key.keystore -Djavax.net.ssl.trustStorePassword=passwd net.sf.odinms.net.channel.ChannelServer
11. Open your command prompt (Start>Run>cmd). Navigate to your java directory (for most people, this is by typing "cd c:\program files\java\jdk1.6.0_06\bin").
12. Type this, set the password to "passwd" and random crap for the personal info:
Code:
keytool -genkeypair -keyalg RSA -keysize 1024 -validity 365 -keystore key.keystore
(It will not seem like it is letting you type anything when you enter your password, but it is, it doesn't show up.)
13. Browse to your jdk \bin folder and copy the .keystore file to your odinms source folder.
Alternative to Steps 12 and 13: You can just download the keystore file from here:
If you use that file, you must use the password "passwd"
14. Copy the two .jar files from the JCE Unlimited Strength folder and put them in the /lib/security folder in your Java directory. Click yes to replace files. Repeat this for ALL of the /lib/security folders in ALL of the jre folders in your Java directory.
15. Make a new folder called wz in your odinms source folder and copy all your .wz files from your MapleStory folder into it.
Running the server
Run the server bat files in this order:
World Server
Login Serer
Channel Server(s)
The easiest way to connect is to use this localhost client:
Put that in your Maplestory game folder and run it. To login, use "admin" as both the username and password. You can create new accounts by opening the MySQL Query Browser, connecting, opening the accounts table by double clicking on it and hitting Execute, click Edit at the bottom, and entering new information in the second row. You can copy the information from the admin account and change it to your liking (remember to assign a different ID). For the password, go to this page:
Enter your password, choose SHA1, and encrypt it. Copy the encrypted password to the password field in the accounts table.
