RO3Emu - play Ragnarok Online 3 (PC) on your own server
=======================================================

Nothing to install. Extract the whole zip, then double-click Ro3EmuLauncher.exe.
If Windows says "Windows protected your PC" (RO3Emu is not signed), click
"More info", then "Run anyway". The launcher needs the Microsoft Edge WebView2
Runtime, which Windows 10 and 11 normally have.

The launcher:
  1. finds your Ragnarok 3 game folder (the one with ro3.exe), or lets you pick it,
     or downloads the game from Genesis' update servers (about 24 GB; every
     file is checked against Genesis' signature);
  2. exports the game data it needs from your game folder (about a minute, first time);
  3. starts the server on this PC when you press Play;
  4. patches the game to talk to it and starts the game.

Log in with any account name and password: the account is created on first login.
The server runs while the launcher is open (it waits in the tray while you play);
exiting the launcher stops it. Settings > Play with friends hosts a server for
friends or joins someone else's. Web panel (top right) opens the server's web
panel in your browser: your account, characters, rankings and, for GM accounts,
the admin area. The launcher updates itself from RO3Emu's releases and shows
what changed.

RO3Emu-Launcher.exe (this realm's simpler launcher) has a button for each of the
commands below (play, join a friend, host, install, update, check, restore,
diagnostics) and remembers the address, game folder and options you used last.
RO3Emu-Player.exe is the short version for joining a friend: install the game,
and play on a friend's server (its address is in Settings, the gear at the top
right). It shows who is online there and the server's news. When that server
offers a newer RO3Emu-Player, it offers the update on start. It needs the
Microsoft Edge WebView2 Runtime, which Windows 10 and 11 normally have.

RO3Emu.exe does the same from a console window, and more:
  RO3Emu.exe                       play on your own server (press Q to stop it)
  RO3Emu.exe join 203.0.113.10     play on a friend's server
  RO3Emu.exe host                  let friends on your network join your server
  RO3Emu.exe panel                 open your server's web panel (panel <address>: another server's)
  RO3Emu.exe install               download the game from Genesis' update servers
  RO3Emu.exe update                update the game from Genesis' update servers
  RO3Emu.exe restore               undo the patch (the game talks to Genesis' servers again)
  RO3Emu.exe diag                  write RO3Emu-diagnostics.zip for a bug report
  RO3Emu.exe help                  everything else

What it changes on your PC
  - In the game folder: a few DLLs in ro3_Data\Managed (the originals are kept in
    ro3emu-backup; "RO3Emu.exe restore" puts them back) and ro3emu\loc_en.tsv
    (English texts made from your own game files).
  - In this folder: data\ (game data and your characters), logs\, downloads\ and
    RO3Emu.settings.json. Delete the folder to remove RO3Emu.
  - Do not use the Genesis launcher to repair the game while you play on
    RO3Emu: it undoes the patch (RO3Emu.exe patches again on the next start).

If something goes wrong
  RO3Emu writes RO3Emu-diagnostics.zip and tells you where it is. Open an issue at
  https://github.com/aethai/ro3emu-server/issues and attach that file.

RO3Emu does not include or host any game file. It is not affiliated with Gravity or
any publisher of Ragnarok Online.
