[Tutorial] Video Edition - How to Setup rAthena and run Ragnarok Updated 2018-7-28

[Earnestinence]

Hello rAthena Community 

I'm Earnestinence, and i'll be guiding you to setup rAthena and run Ragnarok

 

 

Programs you need to install before we start

• Downloads:
  • Github : https://desktop.github.com/
  • MySQL (When installing: make sure to check 'Use Legacy Authentication Method; Retain MySQL 5.x compatibility' ) : http://www.mysql.com/downloads/mysql/
  • MySQL Workbench : http://www.mysql.com/downloads/workbench/
    •  Note: remember the username and password you set when installing ! 
  • Latest Clean kRO Full Client : by: @Akkarin
    • Spoiler

       

  • Microsoft Visual Studio ( MVS ) : https://www.visualstudio.com/downloads/
    • Visual Studio is a code editor supporting and C andC++ compiler. more info Click here by @Aleos
  • Notepad ++ : https://notepad-plus-plus.org/download/
    • Note: Notepad++ source code editor and Notepad replacement ( or just use notepad )
  • 2015-11-04a unpacked client: https://mega.nz/#!w84jRRjZ!iWjU1Qfsez_3nbTtqQuFWHsbda2IglPi7TBnzZWmJtI by: @Napster
    • rAthena support all the clients listed in the packet files : read more

Required Files: 

• After you download and install GitHub download these files using GitHub 
• File > Clone Repository 
  • rAthena ( server ) : 

    https://github.com/rathena/rathena.git 

     

• • English Translated System & Data Folders RE/PRE: by @zackdreaver
  • Spoiler

     

     
    • For Renewal: https://github.com/zackdreaver/ROenglishRE For Pre-Renewal : https://github.com/zackdreaver/ROenglishPRE
  • NEMO Client Patcher : https://github.com/MStr3am/NEMO.git 
    • For more info see this topic by @NeoMind
  • Client Setup : http://nn.ai4rei.net/dev/opensetup/ 
    • Client setup for Ragnarok Online by @Ai4rei

==========================================

Setting up rAthena Server-Side: See video time-line: 00:02

Step 1: Download/Clone rAthena Source

• Open GitHub.
  • Click Clone repository.
  • Click URL tap.
  • Copy and paste this URL: https://github.com/rathena/rathena.git
  • Choose the downloading path.
  • Click Clone and wait for it do finish downloading.

 

Step 2: Configuring rAthena See video time-line: 00:35

• open rathena/conf/import/char_conf.txt
  • Add these lines :
    • userid: username
    • passwd: password
    • login_ip: 127.0.0.1
    • char_ip: 127.0.0.1
  • [Optional] To change server name add this line :
    • server_name: YourDesiredServerName
  • Note: If you want to change anything in char_athena.conf, use the import-tmpl directory to avoid future issues when updating. ( just add the respective value you want ).
• rathena/conf/import/map_conf.txt
  • Add these lines:
    • userid: username
    • passwd: password
    • char_ip: 127.0.0.1
    • map_ip: 127.0.0.1
  • Note: If you want to change anything in map_athena.conf, use the import-tmpl directory to avoid future issues when updating. ( just add the respective value you want ).
• rathena/conf/import/inter_conf.txt
  • Add these lines
    • login_server_db: rathena
    • ipban_db_db: rathena
    • char_server_db: rathena
    • map_server_db: rathena
    • log_db_db: rathena_logs
  • Note: If you want to change anything in map_athena.conf, use the import-tmpl directory to avoid future issues when updating. ( just add the respective value you want ).
  • Note: I use rathena as my main database which contain all main tables (like: chars, login, guilds, etc... ). However, I like to separate my logs to rAthena_logs .

Step 3: Compiling rAthena See video time-line: 02:16

• Locate  rathena/rAthena.sln
  • Locate and right click rAthena.sln open with > Microsoft Visual Studio 2017 ( or 2013 / 2015 )
  • Wait for the MVS to load the project, when it's ready select Solution 'rAthena' (8 projects) and then right click and Click 'Clean Solution' First when clean finish successfully click on 'build Solution'
  • Wait for it to finish, make sure the log below finish successfully 

 

Step 4: Setting SQL Database ( make sure MySQL installed and running ) See video time-line: 03:13

• open MySQL Workbench
  • log in :
    • Using the username 'root 'and the password you set when you first install MySQL ( If you don't remember the password, you can reconfigure MySQL using MySQL installer )
  • once you logged in create new user account and grant Administrator Privileges: - See video time-line: 04:17
    1. In The Left Side click on Users and Privileges 
    2. At The Bottom click on Add account
    3. Set Login Name : ragnarok
    4. Set Password : ragnarok
    5. Set Confirm Password : ragnarok
    6. At The Top Menu Click Administrative Roles: and then check DBA
    7. Click Apply
    8. logout by clicking on X at the top of the current tap and then login using the new user account ragnarok with password ragnarok See video time-line: 05:00
  • Creating databases/schema : See video time-line: 05:26
    • Click on  create new database/schema
    • Set the Name: rathena ( this will be our main database/schema )
    • Set Charset: utf8 ( Now this's is important you need to check this )
    • Click apply, apply and then finish
    • Now Click on  create new database/schema
    • Set the Name: rathena_logs ( this will be our logs database/schema )
    • Set Charset: utf8 ( Now this's is important you need to check this )
    • Click apply, apply and then finish
  • import rathena SQL files to rathena & rathena_logs databases: See video time-line: 06:16
    • Double click on rathena database/schema we've just created
    • Click on  
    • locate rathena folder and go to rathena/sql-files and click on main.sql
    • Click on the light icon  * wait for the tablet to be executed *
    • Double click on rathena_logs database/schema we've just created
    • Click on
    • locate rathena folder and go to rathena/sql-files and click on logs.sql
    • Click on the light icon  * wait for the tablet to be executed *
  • change the username and password of the server: See video time-line: 07:03
    • Now next/around rathena database right click on a blank area and click refresh all ( in order to view the tables we've just created or just relog )
    • Click on rathena database/schema > tables > locate login table..
    • now click on tables and locate login table then right click and click on select Rows - Limit 1000
    • Double click on s1 and change it to username then hit enter  ( we put the userid: username in rathena/conf/import-tmpl/char_conf.txt and map_conf.txt  make sure you use the same one you put in these files  ) 
    • Double click on p1 and change it to password then hit enter  ( we put the passwd: password in rathena/conf/import-tmpl/char_conf.txt and map_conf.txt  make sure you use the same one you put in these files ) 
    • Click apply, apply and then finish

Step 5 ( running the server )

• Running rAthena server See video time-line: 07:35
  • locate rathena folder rathena/ click on runserver
    •  ( less than 8 mins without any errors )

==================================================

 

 

Client Side Running & patch ragnarok online client 

 

• open Official kRO Client/ 
  • Updating kRO Files:
    • Locate and run rsu-kro-rag-lite.exe and wait for it to finish and then rsu-kro-renewal-lite.exe and wait for it to finish updating ..
  • Adding translated system/data files 
    • Locate ROenglishRE or ROenglishPRE and copy Data & System folders , GuildTip  & Tipoftheday
    • and paste these files into the official kro client folder ( Replace the files when asked )
  • Setting up clientinfo.xml : 
    • locate official kRO client folder open folder data/ and edit file clientinfo.xml
      1. change the version to 55 <version>55</version>  (This might not be needed  anymore.)
      2. set the langtype to 1 < To be able to write in English. ( refer to this page to find your preferred language beside English: https://github.com/rathena/rathena/wiki/Clientinfo.xml ).
      3. set admin sprite for any account you want, just put the account id 

         1. <aid>
            	<admin>2000000</admin>
            </aid>

  • Copy and paste the setup file into the the official kRO client folder
  • Patching the Client 2015-11-04 
    • load the client and select recommended and click enter for data.ini and then CHANGE/EDIT system/iteminfo.lub to system/iteminfo.lua and check read data folder first, ignore missing palettes, ignore resource errors and then customize the client as you want

• Here's my additional patches:
  
  >>>
  Custom Window Title ( name you server )
  Disable Swear Filter
  Disconnect to Login Window
  Enable Title Bar Menu
  Read Data Folder First
  Show Cancel To Service Select
  Ignore Missing Palette Error
  Ignore Resource Errors
  Use Ragnarok Icon ( ragnarok icon for the client )
  <<<

  copy the new 2015-11-04aRagexe_patched and paste it your official kRO client folder

 

now the client is ready, just run the game using 2015-11-04aRagexe_patched and Enjoy

to create a male account just type ex: admin_f for female - admin_m for male 

and don't forget to set the account group id 99 to get full GM permissions 

Issue #1: Closed connection from '127.0.0.1'.
Solve:  go to your rathena/src/custom/defines_pre.hpp and open it with notepad++ ( or any notepad ) add this line #define PACKETVER 20151104

 

========================================================

As of 28-7-2018: the topic is fully updated and support MySQL 8.x 

========================================================

For further questions or concerns regarding the tutorial, Do NOT hesitate to contact me in this topic.

- Earnestinence

Edited March 5, 2020 by Earnestinence
Added issue and solve #1

[Earnestinence]

I do not provide support anymore, sorry.

[Akkarin]

Just as a quick note, np++ isn't a requirement. You should also be teaching people how to use the import directories instead of editing files directly within conf/ as this causes the most issues when updating. 

Using wamp for a local server is also overkill with automatic installation of apache and php, as you only need MySQL you'll be better off installing MySQL Community Server and the Workbench tool.

We don't use svn, so TortoiseSVN is the wrong tool.

I'll remove this post once you've fixed your guide.

[Deleted User]

Other note, when compiling rA Emulator I usually make "Clean Solution" before doing "Build Solution". it's an old way that I used in eAthena before.

[sader1992]

Nice Guide , Keep it up 

[Earnestinence]

5 hours ago, Akkarin said:

Just as a quick note, np++ isn't a requirement. You should also be teaching people how to use the import directories instead of editing files directly within conf/ as this causes the most issues when updating. 

Using wamp for a local server is also overkill with automatic installation of apache and php, as you only need MySQL you'll be better off installing MySQL Community Server and the Workbench tool.

We don't use svn, so TortoiseSVN is the wrong tool.

I'll remove this post once you've fixed your guide.

 

4 hours ago, Kaze said:

Other note, when compiling rA Emulator I usually make "Clean Solution" before doing "Build Solution". it's an old way that I used in eAthena before.

Thanks both for the notes, i'll update everything including the video now, and sorry for my mistakes 

[daShiru]

Question how do i make this Test Server Online. My cousin wants to connect so he can help me

[Earnestinence]

1 hour ago, daShiru said:

Question how do i make this Test Server Online. My cousin wants to connect so he can help me

Host it on your PC there's some guides out there in the forums .. so use the search feature 

 

or buy a host .. 

Edited July 27, 2017 by Ciel Phantomhive
added another way!

[EmptyRaiden]

Thank you for this guide. I've got one question: How are you able to compile using Visual Studio 2017? Which tool set is required that you have that I don't? Visual Studio 2017 doesn't support C++ v120 which is the tool set that is required afaik.

Edited August 26, 2017 by Anqayas

[sader1992]

23 minutes ago, Anqayas said:

Thank you for this guide. I've got one question: How are you able to compile using Visual Studio 2017? Which tool set is required that you have that I don't? Visual Studio 2017 doesn't support C++ v120 which is the tool set that is required afaik.

https://github.com/rathena/rathena/wiki/Install-on-Windows

[EmptyRaiden]

19 hours ago, sader1992 said:

https://github.com/rathena/rathena/wiki/Install-on-Windows

I figured it out. I needed to right click on the solution and choose Retarget Solution first, then Clean Solution and finally Build Solution.

Edited August 26, 2017 by Anqayas

[Bolby91]

can you help me with this? i followed all the steps but this happened

[Earnestinence]

On 9/30/2017 at 12:59 AM, Jholz27 said:

can you help me with this? i followed all the steps but this happened

use the same password as your database's login password create user account username: ragnarok password: ragnarok  watch the first video ( Step 1 & 2 ) at: 07:05

[endlessfaith]

Hi!

Firstly thanks for such a detailed guide!

But I'm currently face with some issues with the server. It cant access and login into the SQL.

I tried changing the 127.0.0.1 to localhost and disabled my firewall can't get it to work.

 

 

[Earnestinence]

On 10/5/2017 at 5:12 PM, endlessfaith said:

Hi!

Firstly thanks for such a detailed guide!

But I'm currently face with some issues with the server. It cant access and login into the SQL.

I tried changing the 127.0.0.1 to localhost and disabled my firewall can't get it to work.

 

 

please make sure to check you'r database login info! 

just set it to ragnarok for both username and password !! 

[Hitsukay]

It's my first time using rAthena and making my own server
I was following the guide who has on GiftHub but was not understanding much. So I researched and found your video
I did everything exactly like you did, but this happens when i build solution (sorry for the PT-BR in Visual Studio)

[BURAOT]

On 1/5/2018 at 10:13 AM, Hitsukay said:

It's my first time using rAthena and making my own server
I was following the guide who has on GiftHub but was not understanding much. So I researched and found your video
I did everything exactly like you did, but this happens when i build solution (sorry for the PT-BR in Visual Studio)

Download the latest, then try to built it again

https://github.com/rathena/rathena/archive/master.zip

or you could use this

 

Edited January 9, 2018 by BURAOT

[sader1992]

DON'T DOWNLOAD .zip

use git

[mooncbz]

On 12/27/2017 at 7:48 PM, Ciel Phantomhive said:

please make sure to check you'r database login info! 

just set it to ragnarok for both username and password !! 

I found the problem, your video and your commend are different causing some people confuse.

- At your 1st video, time 4:44 and 8:57, the log database name is "rathena_logs", but your commend is "rathena_log".

We just need to make sure the log_db_db inside \rathena\conf\import-tmpl and MYSQL schema name are same.

 

Edited February 3, 2018 by mooncbz

[GoldRoger]

can teach me how to setting mysql in 6.43minutes..that videos show mysql already installed but i not yet install n setting it..pls teach me where to download n how to setting it pls

 

in minutes 9.34..why my main.sql didnt appear many file?..help me pls

[Cyro]

Innodb is disabled in windows by default, which is why you cannot important those tables

 

Try this

http://codex.galleryproject.org/MySQL:Enabling_InnoDB_on_Windows

[GoldRoger]

like this?..i tried it,still same

[Cyro]

You need to restart your MySQL after modifying my.conf

[GoldRoger]

i already restart it..but it still same..hmmmm..

 

still same..please help me

[joao]

Everything is working fine, except that, when I try openning my diffed client, the game doesn't open. When I ctrl+shift+esc, the process is there, running on the background and consuming 30% of my CPU. Still, the screen doesn't appear. Can anyone help me? Thanks!

 

Edit: Figured it out. I probably skiped the setup step, so the game was running, but not through my GPU.

Edited April 13, 2018 by joao

[associate]

Why does everytime i pick up an item it crashes the game, or click any npc