Shifu-Hacks Blog


OdinMS Source v.53 (Release 0.5)

Posted by compactwater on April29 2008

Note: This same method will work for future releases and updates, so the title may be misleading to some.

And so I’ve decided to write a simple tutorial on how to start a private server from the OdinMS source files, because not many people can understand all the “complicated” stuff behind it. Follow this step-by-step, make sure you do things exactly. At the bottom of this post I will include common errors, and their fix.

Download the following and extract the files to a temporary folder. You will need these for later.

Install MySQL and the Query Browser (or administrator). This will be needed for the game’s database, remember all information you use! Be sure to create constant backups of your database in case problems arise later on. You can do this by selecting your database (default: odinms) and choosing backup, or dump database. It will output a ‘.sql’ file in most cases, keep this file safe as it contains all user information, although encrypted with SHA1, it can still be forced. To import the database from a backup (included in the source) use “File->Open Script”. It will be labeled ‘odinms.sql’. This will automatically create all the tables.
Once completed, goto your OdinMS source folder and edit “” with any text editor and change the information to what you created for your database.
user = root
password = whatever_you_used
If this is not done correctly, you will not be able to connect to the database.

Next to edit is how many channels you want to run, be warned more channels will cause more lag. Open “” and change this line:
You will also need to add a new row for

To change the meso and experience rate, open “”. This is also where you need to change
to your local IP if needed.

So on, now to the batch (.bat) files. Edit them in a text editor (clicking will execute them).
change these lines
Unless you have made any customizations. You may also want to add “pause.” to the very last line to see any errors that occur. If you wish for the server to automatically restart itself upon crashing, add this line to the end, only do this if you know the server is working, else it’ll return the same error repetitively.
It’s that simple. And here’s kill.bat, although this is only a simple work-around.
TAKSKILL /F /IM “java.exe”
start launch_world.bat
start launch_login.bat
start launch_channel.bat

In your MapleStory folder, copy all the .WZ files into your OdinMS folder, to keep it organized make a folder called ‘wz’ and put them in there. OdinMS reads from the WZ files for information.

Find your Java installation (default: c:\program files\java). There should be a few folders, copy ‘loca_policy.jar’ and ‘US_export_policy.jar’ from the Java Cryptography Extension to ‘/lib/security’ and ‘/jre/lib/security’ in all the folders. It should look something like this, depending on what you’ve installed.
Java Folder

Next, you can either make the key files, or download a pre-made key file. It is recommended you make your own. You can get one here, provided by Leena of CEF. Copy the file six times into the OdinMS source folder, and rename them to:

  • world.keystore
  • channel.keystore
  • login.keystore
  • world.truststore
  • channel.truststore
  • login.truststore

Although it isn’t really necessary to create multiple copies of the file, as you can use it for all of the different servers’ keystores and truststores. The password for the world, channel, and login will be “passwd”.

Next, copy “mina-core-1.1.7.jar”, “mysql-connector-java-3.1.14-bin.jar”, “slf4j-api-1.5.0.jar”, and “slf4j-jdk14-1.5.0.jar” to the dist folder in your OdinMS source folder. Rename them accordingly:

This is the last step, the rest is just information on adding accounts and enabling others to play on your server.

To modify an account’s password, use this in SQL:
UPDATE accounts SET password = SHA1(‘password’) WHERE name=’admin’

Or, to create an account with information, use:
INSERT INTO accounts (name, password, birthday, email, banreason, macs)
VALUES(‘username’, SHA1(‘password’), ‘2001-09-11’, ‘’, ‘notbanned’, ‘macaddr’);

This will change the default “Admin” account’s password to “password”. It is a good idea to change this, or even delete this account, as it can lead to vulnerabilities if accessed. The second code will create an account with the username “username” and password “password” as well as the other needed information. If you want to give an account GM access, simply enter this:
UPDATE accounts SET gm=1 WHERE name=’username’;

Having others connect to your server: This is limited by two things. Your router (if you have one) and your ISP. If your ISP is very restrictive, then you just cannot host a server for others to play on. If you have a router, you will need to forward ports to your computer’s local IP address. The router’s address is typically ‘’, if you are asked for a password, it should be the default for your router, usually printed on the router itself. If the default password does not work, try resetting it. Your local IP will look something like:, and may change from time to time if you do not register it to your MAC address.

Once on your router, forward ports 8484, and 8888 to your local IP. You can goto a site (such as to find out your IP. There are two ways you can let others connect to your server with this, hex editing the client’s IP to yours, or executing it through CMD like so: “MapleStory.exe 8484”, although you could use a batch (.bat) file to do it for you. Another method is with Hamachi, or such applications. Use your Hamachi IP rather than your actual IP.

Common Errors, and fixes:

Currently, there are no common enough errors to report. Feel free to e-mail me if you have troubles, and I will try my best to find a fix and add it here.


17 Responses to “OdinMS Source v.53 (Release 0.5)”

  1. […] Posted by compactwater on February11 2008 (If you are looking for help on the OdinMS source, you can find that here.) […]

  2. tony said

    um everytime i try to open the world channel or login it closes right away

  3. Try adding ‘pause.’ to the last line, this will stop it from closing and let you read the error.

  4. Noir said

    Hi, I was wondering, how exactly do you make a modified game client that removes gameguard? It causes a lot of problems for me (GMS takes me 1~2 hours to load) and I’m sure it’s GG that’s causing it because a private server that I was playing that removed GG loaded up in a second.

    Thanks. 🙂

  5. Richard said

    were do u find those .jar files to copy and rename?

  6. Derr said

    Very Unclear. You don’t point out where the files are located and i’m sure everyone who has tried to follow this have lots of trouble finding them. 6/10 i give it 😛

  7. HammerTime said

    Ok ive got a problem! i finaly got to read the error thanks to the ‘puase.’ Ty for that!
    But not it says[ Exception in thread “main” java.lang.NoClassDefFoundError: Org/slf4g/loggerfactory at ]

    Anyhelp??? plz its killing me

  8. Patrick said

    Hi, I run a private server called VaderzMS, the website is “”. My problem is when I execute the

    UPDATE accounts SET password = SHA1(’password’) WHERE name=’admin’
    query, it returns an error. It says unkown column admin in where clause.

    I’m using MySQL Quey Browser V 1.2.12
    Please help!

  9. NormalMS said


  10. SriBlack said

    I’ve got a problem that when I log in and try to select my character it kicks me back to the login screen and says cannot connect to server. What do I do?

  11. MisterGoldenrod said

    where do i press host server anyways. u wrote to host server : ip etc etc but wher exactly do i enter the ip and stuff…

  12. You Mean All inside Nexon Folder(download from global v55) copy to WZ file right??

  13. luis said

    Ayuda cree mi server pero cuando cree la cuenta por mysql y entro al juego y me dice clave error clave incorrecta como ago para entrar a mi server llamenme a este numero 04162713674 o escrivanme a este email

  14. luis said

    Ayudo a el que me hable

    se algo de como hacer ese server

  15. Nice post! These are important things to stay in mind, it’s often straightforward to forget about the straightforward things once you get consumed by a project.

  16. Jamika said

    It’s a relief that I was able to come across it has the info I was actually hunting for. It’s extremely helpful and you’re obviously highly knowledgeable in this field. You have opened up my mind to a number of thoughts related to this kind of subject employing interesting and effective material.

  17. Festung said

    You really make it look so with your delivery but I find this subject to be actually one thing that I believe I’d by no means understand. The whole thing just goes over my head because of how intricate and broad it all is.. I am looking forward to your following publishings, I will try to get the dangle of it.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google+ photo

You are commenting using your Google+ account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )


Connecting to %s

%d bloggers like this: