[Guide] Create your server & Client (2016/08)

[Monsieur Panda 38]

Hello,

For some reason, I decided to write my own guide for super newbie people. And when I say newbie, I say REAL newbie. I will not ask you to learn anything or saying rude things like "go google ffs".

I believe people that want to create their server are not necessary interested being a linux master or whatever. Never people are saying that before leaning guitar, people should learn how string and guitar are made.

Enough talk, lets start !

 

 

Prerequisites

• Patience, meticulousness, cogitation
• kRO full client: Mirror #1 (mediafire), Mirror #2 (Direct Link from my ftp)
• kRO last actual compatible exe: Mirror #1 (mega.nz), Mirror #2 (Direct Link from my ftp)
• Setup exe: Download (Page), Mirror #1 (Direct Link from my ftp)
• N.E.M.O. Diff Patcher Download (git)
• BGM parameter files. Download (Direct Link herc.ws), Mirror #1 (Direct Link from my ftp)
• Translation Package. Download (git)
• Putty: Download (Page)
• If Putty does not work, use Kitty Download (Page)
• 1~2 hours of your time

Things you should know:

• You cannot see password in Putty / Kitty when you type it.
• nano is a text editor. At the bottom of the screen you can see a menu. To use it, press CTRL + the option's letter
• You cannot use numeric pad in nano
• Being polite is always rewarding

 

I. Dedicated server

 

A. Get your server

1. You can find very cheap solution at Kimsufi. Choose anything you want.
2. I recommend you to choose Debian 8 (Jessie) for your OS. 
3. In Kimsufi manager, you will find your server IP.
4. You have your login (root) and password in an email after installing the OS

B. Configure your server

1. Start Putty and enter server's IP address
2. Connect with root then type the password you got by email. (You wont see " * " when you type)
3. To change your password enter the following line
   • passwd
4. Install required package by enter this (copy this and paste it with a right-click):
   • apt-get install git make gcc mysql-server libmysqlclient-dev zlib1g-dev libpcre3-dev screen
5. ​The following is meant to make a web server. Even if you don't plan to make a website, I suggest you to take it, just because phpmyadmin is easy to use. While installing phpmyadmin, select apache2.
   • apt-get install apache2
   • apt-get install php5 php5-cli libapache2-mod-php5 php5-mysql
   • apt-get install phpmyadmin
   • ln -s /usr/share/phpmyadmin /var/www/html/
6. ​Because hercules doesn't work if you use root login, we will create a new user.
   • useradd ragnarok
   • passwd ragnarok [choose_a_password]
7. Connect to phpmyadmin and login with the information you chose at this address: http://your_server_ip/phpmyadmin
8. Create a new database ragnarok and choose utf8_unicode_ci as collation
9. Create another database and name it ragnarok_log with same collation
10. Click on the tab Users (top of the page), Add User and fill the form.
    • Username: ragnarok,
    • password: [choose_a_assword],
    • Click on Check All in the privilege group. (or if you know what are you doing, select options you need)
11. Now you can log out from your server in Putty
    • logout

C. Install Hercules

1. Login again in Kitty with the new user ragnarok
2. Download Hercules emulator
   • git clone https://github.com/HerculesWS/Hercules.git ~/Hercules
3. We will need to reach the database installation folder:
   • cd Hercules/sql-files/
4. We will now import tables in the database. You will have to write your mysql password each time (set in step B.4).
   • mysql -u ragnarok -p ragnarok < main.sql
   • mysql -u ragnarok -p ragnarok_log < logs.sql
   • mysql -u ragnarok -p ragnarok < item_db2.sql
   • mysql -u ragnarok -p ragnarok < mob_db2.sql
   • mysql -u ragnarok -p ragnarok < mob_skill_db2.sql
5. if you want to make a PRE-RENEWAL server, enter also this
   • mysql -u ragnarok -p ragnarok < item_db.sql
   • mysql -u ragnarok -p ragnarok < mob_db.sql
   • mysql -u ragnarok -p ragnarok < mob_skill_db.sql
6. If you want to make a RENEWAL server:
   • mysql -u ragnarok -p ragnarok < item_db_re.sql
   • mysql -u ragnarok -p ragnarok < mob_db_re.sql
   • mysql -u ragnarok -p ragnarok < mob_skill_db_re.sql

D. Configure hercules

1. It is required to set up a server login and password for char-server, map-server and the login database. It can be done by editing few files and the table login.
2. Start by editing conf/inter-server.conf.
   • cd ../​​
   • nano conf/inter-server.conf
3. Find the line sql.db_username and fill it with the user and password we created in step B.10. fill also the database name with ragnarok
4. As the same time, you will need to edit conf/import/inter_conf.txt.
   • nano conf/import/inter_conf.txt
   • sql.db_username: ragnarok
     sql.db_password: your_sql_password
     sql.db_database: ragnarok
   • log_db_id: ragnarok
     log_db_pw: your_sql_password
     log_db_db: ragnarok_log
5. now edit conf/import/char_conf.txt and fill it with this following text
   • nano conf/import/char_conf.txt
   • // Server Communication username and password.
     userid: [new user]
     passwd: [new password]
6. Do the same to conf/import/map_conf.txt with the same userid and passwd.
   • nano conf/import/map_conf.txt
   • // Server Communication username and password.
     userid: [new user]
     passwd: [new password]
7. You will need to update the login table from ragnarok database. Connect again to your phpmyadmin (I.B.7)
8. Find the table login and edit the only row available.
   • userid must have the same value as [new user]
   • user_pass must have the same value as [new password]
9. char-server.conf
   • nano conf/char-server.conf
   • server_name: [your_server_name]
   • wisp_server_name: Admin
10. For some reason, you must reboot your server.
    • reboot
11. Close the Terminal and connect again after a minute.
12. Now you will need to work on your server ports
    • iptables -I INPUT 1 -p tcp --dport 6900 -j ACCEPT
    • iptables -I INPUT 1 -p tcp --dport 5121 -j ACCEPT
    • iptables -I INPUT 1 -p tcp --dport 6121 -j ACCEPT
    • iptables save
13. We are done with the server for now. You can log out if you want. Lets prepare our client!

 

II. Create the Client

 

A. Organization

1. Extract the full client in C:\ro_client\RO\ and launch update with rsu-kro-renewal-lite.exe or rsu-kro-rag-lite.exe if you set a pre-re server.
2. Extract the Ragexe.exe in C:\ro_client\fresh\
3. Extract data and System folders from the translation Package in C:\ro_client\fresh\
4. Extract the opensetup.exe in C:\ro_client\fresh\
5. Extract Mssfast.m3d and Mp3dec.asi from BGM.zip in C:\ro_client\fresh\
6. Extract N.E.M.O. content in C:\ro_client\NEMO\
7. Once Step 1 is DONE:
   • Copy All *.dll and *.INI files from C:\ro_client\RO\ to C:\ro_client\fresh\
   • Copy BGM and savedata folders from C:\ro_client\RO\ to C:\ro_client\fresh\
   • Copy rdata.grf and data.grf files from C:\ro_client\RO\ to C:\ro_client\fresh\

B. Configure the Client

1. Launch N.E.M.O. and load 2015-05-13aRagexe.exe 
2. Hit "Select Recommended"
3. Confirm DATA.INI
4. Rename iteminfo.lub to iteminfo_n.lub
5. Now search "Read Data Folder First" and check it
6. Hit "Apply Selected" and you will have a new 2015-05-13aRagexe_patched.exe file.
7. You should "Save Profile" now, because you will probably want to edit again your client later

C. Add the translation

1. Rename C:\ro_client\fresh\System\itemInfo.lub to iteminfo_n.lub
2. You might need to rename C:\ro_client\fresh\data\texture\À¯ÀúÀÎÅÍÆäÀ̽º\ folder to 유저인터페이스 later, but for now, just skip this step (not sure if you encounter this problem).
3. Open C:\ro_client\fresh\data\clientinfo.xml with a text editor (I recommend Notepad++)
4. Update the address with your server IP
   • <address>[ip_address]</address>
5. Done with the translation. Now we will say to the server, which client players are using.

 

III. Finish Server configuration

 

A. Compile the server

1. Launch Putty again and login to your server. We will compile Hercules. It will take time so be patient.
   • cd ./Hercules
   • ​​./configure --enable-packetver=20150513
   • make clean
   • make sql
2. once it is done, you can verify if the version has been properly set.
   • nano src/common/mmo.h
3. Find following lines
   • #ifndef PACKETVER
             #define PACKETVER
4. Change #define PACKETVER to #define PACKETVER 20150513 if not done yet.
5. If you did change something in mmo.h, you need to recompile again. Process again the step III.A.1

B. Start the server

1. To start the server, you simply need the following line (while being in Hercules folder)
   • ./athena-start start

 

 

IV. Player Side

 

A. Create a Game Master Account

1. Go to your phpmyadmin (step I.B.7) and find again the login table.
2. Hit the Insert tab
   • userid: [login_nickname]
   • user_pass: [login_pass]
   • group_id: 99
   • gender: M or F
3. You have now your Game Master Account

B. Play

1. Launch C:\ro_client\fresh\2015-05-13aRagexe_patched.exe
2. Login with your newly created game master account
3. Process thru in game.
4. type @go 0
5. Be happy.

 

V. Customize

 

A.  Back to the N.E.M.O.

1. This Diff patcher is really cool, be aware of that. You can now edit again your client.
2. repeat the step II.B.1
3. Hit "Load Profile" and choose the previous file you created in step II.B.7
4. Check the list and hit option you want.
5. repeat step II.B.6 and 7

B. Options & Fix

1. Remove the Pin Secure Code
   • Be sure to always be in Hercules folder ( cd ./Hercules)
   • ./athena-start stop
   • ​​nano conf/import/char_conf.txt
   • add this line: pincode_enabled: 0
   • process to step III.A.1
2. To edit clientinfo.xml, I suggest you to check the wiki page
3. if you can't see in game button
   • Rename C:\ro_client\fresh\data\texture\À¯ÀúÀÎÅÍÆäÀ̽º to 유저인터페이스
   • Get Unbollox: Download (Download Page), Mirror #1 (Direct Link from my ftp)
   • In unbollox, select the texture folder and click on À¯ÀúÀÎÅÍÆäÀ̽º
4. Changing starting point
   • nano conf/import/char_conf.txt
   • add start_point_re: prt_fild08,170,365
5. Changing starting items
   • nano conf/import/char_conf.txt
   • ​add start_items: 2393,1,0,5055,1,0,569,20,1
6. Changin starting Zeny
   • nano conf/import/char_conf.txt
   • add start_zeny: 5,000
7. == More options to come, just reply to this topic if you can't find how to do what ==

C. Adding Custom Content

1. NPC
   • ​Add your script in npc/custom/your_script_name.txt
   • Edit npc/script_custom.conf and add the following line:
     • npc: npc/custom/your_script_name.txt
2. ITEM
   • Read the wiki about custom item (Link)
   • System/iteminfo_n.lub
     • [<item id>] = {
       unidentifiedDisplayName = "My custom Item", // Or "Accessory" or "Headgear" if it is an equipment
       unidentifiedResourceName = "my_custom_item", //This will set the sprite you will use (ex: my_custom_item.spr / actmy_custom_item.act)
       unidentifiedDescriptionName = 
       {
                   "Unknown Item, can be identified by using a ^6666CCMagnifier^000000."
               }, //Or basically juste { }, if it is not an equipment.
       identifiedDisplayName = "My custom Item",
       identifiedResourceName = "my_custom_item",
       identifiedDescriptionName = 
       {
                   "Bleh this item is a custom item.",
                   "Bleh this is a second line"
               },  // Description of your item.
       slotCount = 0,
       ClassNum = 0 // Read the wiki page for the list.
       },
   • Sprites.
     • Drop item sprite (also the same as click and drag) must be in:
       • data/sprite/¾ÆÀÌÅÛ/my_custom_item.spr / my_custom_item.act
     • Inventory texture (24x24 size 256 bit bmp) must be in:
       • data/texture/À¯ÀúÀÎÅÍÆäÀ̽º/item/my_custom_item.bmp
     • Headgears: Copy the headgear in:
       • data\sprite\¾Ç¼¼»ç¸®\¿©\¿©_my_custom_item.spr / ¿©_Helmet.act for Female
       • data\sprite\¾Ç¼¼»ç¸®\³²\³²_my_custom_item.spr / ³²_Helmet.act for Male
     • Collection picture (75x100 256 bit bmp) must be in:
       • data/sprite/¾ÆÀÌÅÛ/collection/my_custom_item.bmp
3. MAP
   1. Cient side
      • Your map file name and ID cannot be longer than 13 caracters.
      • ​my_map.gat, my_map.gnd, my_map.rsw, my_map.extra must be in data/ folder (inside grf)
      • Additional textures (bmp) must be in data/texture/À¯ÀúÀÎÅÍÆäÀ̽º/map/ 
      • BGM must be in BGM/ folder.
      • Add the bgm in data/mp3nametable.txt (ex: my_map.rsw#bgm\\44.mp3#)
      • Add following lines to data/resnametable.txt
        • my_map.gnd#my_map.gnd#
          my_map.gat#my_map.gat#
          my_map.rsw#my_map.rsw#
      • Add this line to data/mapnametable.txt
        • my_map.rsw#Title of my Map#
   2. Server Side
      • Add the following line to​​ db/map_index.txt
        • my_map
      • Add the following line to conf/maps.conf
        • map: my_map
   3. Cache
      • Create a map.grf and include a folder data/. Add inside your map files (gat, rsw, gnd, extra)
      • Create a folder grf/ in your server root (Hercules/) and upload map.grf inside grf/ folder.
      • Connect via ssh (putty) to your server and log in.
      • Stop your server 
        • ./athena-start stop
      • Edit conf/grf-files.txt
        • ​nano conf/grf-files.txt
      • Add the following line, save and close.
        • ​grf: grf/map.grf
      • Do the following command
        • ./mapcache
      • start your serveur
        • ./athena-start start

Edited August 24, 2016 by Monsieur Panda

[AkQ 1]

Imo, people who doesn't know basic, or at least, cannot even do basic search, should not open a server. But right, next guide will have a section "to go further" explaining security and other

I could not agree more. But your guide makes it possible to host server without almost any knowledge at all. At that point, "should" and "should not" -things don't really matter.

 

If you need help with next guide, i'm up. I was actually thinking to make a Debian guide myself, with exception of using two servers, one for emulator and one for web-server. But i never seem to have time to do it.

[Monsieur Panda 38]

Got it, I'll come to you when I will start it !

[Luffy 14]

a guide too for Windows User

[Hafflex 0]

Thanks for this guide, helps a lot of newbies.

[AkQ 1]

This should be sticky, and add to the topic title: "Debian/Ubuntu"

[roking 0]

im facing problems, my char and map server starts just fine, but whenever i start the login server, it will await connection to char server, once done the login server will crash. 

[Valterri 0]

Great Tutorial..thnx man.

 

But...appear this error for me

 

clif_parse: Received unsupported packet (packet 0x49f0 (0x49f0), 13 bytes received), disconnecting session #7.

 

anybody know how i resolve this??

[kanemi 0]

Edit: Nothing, sorry.

Edited November 27, 2016 by kanemi

[n0tm3 1]

I followed your instructions, but I am stuck. after selecting server, it wont continue to the character selection screen. it will only say failed to connect to server. whenever I look at the console of the herc emulator, there is no error. can you help me please?

[larva 0]

Hello, im trying to setup the server but the compile gives me a error of mysql.

checking for mysql_config... no
checking for mysql_init... no
checking mysql.h usability... no
checking mysql.h presence... no
checking for mysql.h... no
checking MySQL library (required)... no
configure: error: MySQL not found or incompatible
 

Server OS. OpenSuse 42.1 x64

Mysql version:

> mysql -V
mysql  Ver 15.1 Distrib 10.0.25-MariaDB, for Linux (x86_64) using readline 5.1
 

any help would be appreciated.

Opensuse is not so diferent than CentOS i assume it should work?

 

 

EDIT:  i know whats the problem.... the problem is that i moved mysql to another location (hard drive space issues)..  tested the ./configure in a clean setup and compiled with out problems.

now the real question is. how can i tell the ./configure where is the new location of mysql ?

thanks.

Edited December 1, 2016 by larva

[Tristan 0]

only +9 reputation including mine oh come on guys this guy needs more than that!  

[Rockstar xD 0]

I've tried to compile the emulator using Visual Studio 2017 RC and it returned me the following error:

 

C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\Common7\IDE\VC\VCTargets\Microsoft.Cpp.Platform.targets(57,5): error MSB8020: The build tools for v140 (Platform Toolset = 'v140') cannot be found. To build using the v140 build tools, please install v140 build tools.  Alternatively, you may upgrade to the current Visual Studio tools by selecting the Project menu or right-click the solution, and then selecting "Retarget solution".
4>Done building project "map-server.vcxproj"
 

Anybody knows how to fix it? I have 8 errors at end of compilations attempts.

 

@EDIT

I'm sorry! I posted this too early, guys.
I followed the web instructions and I installed the tools, retargeted the solutions and it worked! (at my second attempt to do this! finally works!)

Edited February 16, 2017 by Rockstar xD

[kbruce 0]

Im getting an unable to locate file errors when i try to type in the 

Install required package by enter this (copy this and paste it with a right-click):

• apt-get install git make gcc mysql-server libmysqlclient-dev zlib1g-dev libpcre3-dev screen

is this too outdated or am i doing something wrong?

[Blubkeks 1]

Hey. Can i use a MySQL dB from Other Server ? Because i have too

[KirieZ 88]

9 hours ago, Blubkeks said:

Hey. Can i use a MySQL dB from Other Server ? Because i have too

It should be possible if you change it on sql_connection file (https://github.com/HerculesWS/Hercules/blob/stable/conf/global/sql_connection.conf#L46) but I wouldn't recommend doing so as this will probably make queries take longer.

[hadiesyafiq 7]

Need help...i just rent vps digitalocean debian 9 i follow the guide but not work 

[Chatterboy 8]

5 hours ago, hadiesyafiq said:

Need help...i just rent vps digitalocean debian 9 i follow the guide but not work 

what is the exact problem?

[zidclide 0]

I'm new to Hercules. Because I learned developing RO private server using rAthena but I red that hercules is better on pre-renewal.

And this is my first guide here.

Am I too late for everything?

 

and also can I test this with local on windows 7. 

[Hadrian 0]

Whenever I try to execute Step C.2 i get message git not found.

I have tried to install git, but it still says the same.-

Somehow it got solved, I'm not sure how, but I did the following:
tried "git_config --list" to receive message git_config not found, installed git using "sudo apt-get install git-core", then typed git to receive list of options, and then it started to work.

Edited April 2, 2020 by Hadrian

[Hadrian 0]

The guide really needs to be updated, with some screenshots and notes on what each step does.

 

Literally with each step I get a lot of issues.

At the moment I can't do steps in D part, because they lead to non existing files, such as "nano conf/inter-server.conf"
That file does not exist in conf folder.

Edited April 2, 2020 by Hadrian

[Hadrian 0]

I have been trying to set up online server for two days, and somehow no one knows what to do?
How am i supposed to do this with outdated guides, that don't work for latest release?
it could be much easier if the guide was something than a monkey task - watch and repeat, but the way it's written - watch and repeat, I really don't understand much, and can't go around issues on my own.

[Kurimon1393 0]

DO you have to Download mirror 1 and mirror 2 ?? :O im new to this

[codes 0]

Hi everyone! i am a newbie and got no idea about programming, kinda wanna learn how to make this. First question is, are you required to subscribe to those server things that he posted? if yes, why? anyone willing to help and guide a complete idiot?

[Chatterboy 8]

On 4/24/2020 at 4:24 AM, codes said:

Hi everyone! i am a newbie and got no idea about programming, kinda wanna learn how to make this. First question is, are you required to subscribe to those server things that he posted? if yes, why? anyone willing to help and guide a complete idiot?

If you don't understand completely how to run. Here watch and learn visually here and how, its a bit different but much easy to understand while watching it running from scratch to finish

 

Edited June 3, 2020 by Chatterboy

[Vejova 0]

So when I run rsu-kro-rag-lite-updater (step II.A) it gives a "mirror server down, try again later" error. Always.

 

I've also tried getting the most up-to-date version of this from here: http://nn.ai4rei.net/dev/rsu/

and I get the error "failed to retrieve 1_patch.txt"

 

What's going on here? What do I do? Is this guide out of date too, or do i just need to wait?

 

Edit - I've also tried installing the up-to-date kRO client from here: 

and ran the patcher it comes with.... the updater there says mirror server is down.

 

 

Edited June 29, 2020 by Vejova
more info