Skip to content

Running

Lucas Pütz edited this page Apr 15, 2024 · 7 revisions

Requirements

In order to run the client, you will need to get the data.grf and rdata.grf from the official kRO client. Place them both inside the korangar directory (korangar/korangar) and start the client using the commands shown in the Installation section, swapping out build for run. For example:

cargo run --release --features debug

Note: As of now, you need to run the client from korangar/korangar so it can find the relevant files.

Game servers

🔓 Remote server

By default, Korangar will try to connect to a remote rAthena instance that I host for development purposes. Since it is intended to be used for testing, I have modified it a bit to make everyone's life easier. These changes include:

  • No packet obfuscation, meaning the network traffic is unencrypted
  • Anyone can use @-commands from the instant they are placed into the tutorial
  • Deleting characters does not require any wait time or confirmation

🔒 Local server

You can also tell Korangar to connect to a server on your local machine by enabling the local feature during compilation. If you are interested in setting up a server locally I suggest reading the install instructions on the rAthena GitHub page.

Logging in

If everything starts correctly, you should see a window prompting you for a username and a password. You can create a new user by entering your desired username with the suffix _m or _f (for male and female respectively) and your desired password. Hint: remember to remove the _* suffix the next time you want to log in to your account.

⚠️ Important disclaimer

Please don't use any of your usual credentials as I will be able to see them in the database. They will also be saved in plain text in the client folder if you tick the boxes during login.

🫀 Creating a character

After logging in, you will be able to create a new character. If the character creation fails, it might be because you are using invalid characters in the name (e.g. _).

Keybindings

Since there is no mention of this anywhere in the game currently, I will briefly mention that you can move and resize windows by holding down Shift and dragging with your mouse buttons.

Troubleshooting

If the client keeps crashing or you have any other problems, please consult the wiki page on Troubleshooting.