Skip to content

Installation

If you have trouble using this translation project, here is a tutorial how to do so.

Downloading

I recommend you to use TortoiseGit to download this project.

Optional is that you download the repository, in a Zip format, but then you have to download the whole project again when I make updates, not just the updated files.

Translation Folder

With commit of 10th December 2023, the default version of this project is 2015-10-29 again! Therefore I added a few simple .bat files to generate the desired Client folder.

  • ClientGenerator.bat
    Copies the necessary files based on selected type and client date into a generated Client folder.
  • AdditionsGenerator.bat
    Copies files from the Additions folder based on your selection into a generated Client folder
  • CLSGenerator.bat
    Copies the CLS (Custom Lua Support) based on your selection into a generated Client folder

Basic Files Setup

Data Version

Move the data folder in your Ragnarok root folder (where you're .exe is located)
Be sure that your client is patched with "Read Data Folder First" (it's not recommended by default)

Note: The client will read everything else missing from the GRF's listed in DATA.ini afterwards!

GRF Version

Pack the data folder in a GRF and add your custom GRF in the DATA.ini as first entry.
Example:

[Data]
0=server.grf
1=data.grf
2=rdata.grf
Required Program - GRF Editor

System Folder

The System folder can't be placed in a GRF, so it goes also in the root folder.

Client Patchers

To be able to patch an unpacked kRO Ragexe, you require one of these programs:

Note

I still need to test WARP2025 and WARP2026, if they are able to patch older clients.

  • WARP by Neo-Mind:
    Original successor to NEMO, but hence dropped support by Neo for unknown reasons, maybe real-life.
  • WARP2025 by skylove:
    For any Client newer than 2022-04-06, see more info in the rAthena Forum.
  • WARP0716 by CrazyBepop:
    For ONLY the 2025-07-16 Ragexe, see more info in the rAthena Forum.
  • WARP2026 by VictorHug0:
    You can get an 2026-01-07 Ragexe in the rAthena Forum.
    I tested both with the 2026-02-19 kRO Full Client and the project files using [27] from the ClientGenerator.bat and didn't encounter any errors.

Session & Profiles

The easiest way to use this project is by taking advantage of the WARP Session feature.

Profile/Session Usage for
2015 Any client in 2015 until you reach a certain date
2019-06 2019-06 and higher

Each profile/session has the patches with the required values already pre-defined,
like System\itemInfo.lub -> SystemEN\iteminfo.lua, so you only have to press "OK" to confirm the patches
in Nemo while in WARP it applies automatically.

Example - Client 2018-06-20 until next profile

  1. "Load Session file" and select 2018_Translation.yml > Confirm patches
  2. "Select Recommended" after applying any session.
  3. Now you can select your custom changes you want, like "Custom Windows Title" and so on.
  4. "Apply Patches" and test your client.

Recommended Quests

SystemEN\RecommendedQuests.lub contains the latest kRO content which are mostly not implemented yet by rAthena.
So you can stick to the SystemEN\RecommendedQuests_basic.lub if you want as well.

2025 Full Clients and Ragexes

Disclaimer: This was written on 25th April 2026 and might/will change in the near future.

With the recent changes to the project and kRO clients (since 2025-07 and 2025-12-04),
I will recommend one of these two full kRO clients, which were kindly provided by skylove:

  1. 2025-07-16:
    You will need to update this client, otherwise you will get a few lua errors duo the project being more up to date.
    Or you'll get the files you error at from the Tools\AdditionsGenerator.bat.
    Feel free to also download the kro_data.grf` to get newer resource files.
  2. 2026-02-19:
    You don't need my custom kro_data.grf, as it already contains files from it. Skylove told me to avoid updating this client as well. So you have been warned.
    From what I have seen, the data.grf in there is fully accessable by GRF Editor,
    but I might be wrong about that.

Important kRO Client changes

  1. Clients/GRFs above 2025-07-16 implemented GRF v3 support, which increases the max size an GRF massively.
    But this also requires newer clients. Clients like 2022-04-06 will not work anymore.
    I didn't test which clients would still work with GRFs like that.
  2. Clients/GRFs above 2025-12-04 received a new GRF encryption, which are also not accessable to older clients.
    Even GRF Editor (to this date) can't encrypt them.

WARPGATE by CrazyBepop

Description

A multi-client downloader and auto-updater for Ragnarok Online. rAthena Forum

WARPGATE bases your client folder on a 2025-07-16 kRO Full Client with updates up to 2026-06-04 (based on CrazyBepop's last public share of encrypted GRF data). rAthena Forum

You can multiple client folders for various setups, which are handled by Warpgate as well.
It access my translation project and CrazyBepop's WARP (WARP0716) to patch your Ragexe with.

In other words, an all-in-one downloader without the need to look for other files, especially if you want to use a 2025-07-16 client.