How to play Ragnarök Online on OS X

Visit Ragnarök Online's community page on CodeWeavers's web site to collect a 25% discount on CrossOver.

  1. Introduction
  2. Installation
    1. Installing the client
    2. Configuring your keyboard
    3. Configuring the client's key mappings
    4. Installing extra content
      1. General
      2. AzzyAI
  3. Usage
    1. Modifying the client's configuration
    2. Multi-clienting
  4. Tips
  5. Common problems and their solutions
  6. Common questions and their answers
  7. Glossary
  8. Comments

Introduction

The IRO client running on OS XThis guide explains how to play Ragnarök Online natively on OS X (the Mac operating system) using CrossOver, with a primary orientation towards the International Ragnarök Online (IRO) client.

Installation

Installing the client

There is a bug in the IRO Pre-Renewal ("Classic") client that causes its window to be set to a tiny size when it is opened for the first time. To work around this problem, do the following after installing the client:

  1. In CrossOver, select the bottle that contains your Ragnarök Online client installation.
  2. Choose BottleRun command… from the menu bar.
  3. Press Browse…, navigate to the client installation folder, and then choose the file Setup_Classic.exe.
  4. Press Run.
  5. Press OK.
  1. Download the IRO client installer. (If you wish to download the installer from the official source, then see Common questions and their answers.)
  2. Download, extract, and then open CrossOver.
  3. Open the Ragnarök Online client's CrossTie profile.
  4. If you are prompted to choose an installer file, then do so, and choose the Ragnarök Online client installer file (Ragnarok_Installer.msi).
  5. Press Install.
  6. Complete the installation processes.
  7. Wait until CrossOver has finalised the installation and then press Done.

Configuring your keyboard

Most or all of the function keys (the top row of keys prefixed with "F") on Mac keyboards are mapped to special functions by default, such as adjusting the brightness of the display, which prevents them from being used to control applications, including the Ragnarök Online client. You can hold the function key (which is labelled "fn") while pressing the function keys to control applications, but this is impractical while playing games. Therefore, before playing Ragnarök Online, you should do the following:

  1. Open System Preferences.
  2. Choose Keyboard.
  3. Open the Keyboard tab.
  4. Tick/check Use all F1, F2, etc. keys as standard function keys.
  5. Press command-L.
  6. Choose Mission Control.
  7. Change the Show desktop and Show Dashboard shortcuts so they don't use the function keys, or disable them.

    I recommend that you change the shortcuts to control-F11 and control-F12 respectively. (Hold control while choosing a shortcut to use it as a modifier.)

Configuring the client's key mappings

By default, the sit/stand and save screenshot functions are mapped to keys that do not exist on Mac keyboards. To change the key mappings of these functions:

  1. In the client, press alt-V to expand the Basic info window if it is collapsed.
  2. Press Option (below the Basic info window).
  3. Press Shortcut configuration.
  4. Open the Interface tab.
  5. Click Sit/stand up and then press the desired key.
  6. Click Take a screen shot and then press the desired key.
  7. Press OK.

I recommend that you change the mappings of the first row of shortcut bar items from the keys F1–F9 to 1–9, and then map each of the sit/stand and save screenshot functions to one of the now available function keys.

Installing extra content

General

To install extra content, such as skins, guild emblems, and AI systems:

  1. In CrossOver, select the bottle that contains your Ragnarök Online client installation.
  2. Choose BottleOpen C: drive from the menu bar.
  3. Navigate to the client installation folder in the new Finder window that is opened.
  4. Move the desired content into the appropriate folder:

    AI systems: AI/USER_AI
    Guild emblems: emblem
    Skins: skin

AzzyAI

To install AzzyAI:

  1. Download and then extract AzzyAI.
  2. In Finder, open the folder that contains the extracted files.
  3. Press command-A, command-C to copy all of the items in the folder to the clipboard.
  4. In CrossOver, select the bottle that contains your Ragnarök Online client installation.
  5. Choose BottleOpen C: drive from the menu bar.
  6. Navigate to Client installation folder/AI/USER_AI (where Client installation folder is the path to the client installation folder).
  7. Press option-command-V to move the items you copied in step 3 into the USER_AI folder. (If you are using OS X Snow Leopard or earlier, then you must instead press command-V to copy the files.)
  8. Open the Ragnarök Online client, log in, and then enter the commands "/merai" and "/hoai" to delegate control of your mercenaries and homunculi to AzzyAI.

AzzyAI includes a GUI-based configurator that enables you to easily customise the behaviour of your mercenaries and homunculi. To install the components required by the AzzyAI configurator:

  1. In CrossOver, choose ConfigureInstall software… from the menu bar.
  2. Install Microsoft .NET Framework 4.0 into the bottle that contains your Ragnarök Online client installation. Choose Restart now when you are asked whether you want to restart your computer. (Your computer will not actually be restarted; CrossOver will merely simulate a restart of Windows within the bottle.)

To add an item for the configurator to CrossOver's bottle manager:

  1. In CrossOver, select the bottle that contains your Ragnarök Online client installation.
  2. Choose BottleRun command… from the menu bar.
  3. Press Browse….
  4. Navigate to Client installation folder/AI/USER_AI (where Client installation folder is the path to the client installation folder).
  5. Choose the file AzzyAIConfig.exe.
  6. Press Save command as a launcher.

Usage

Modifying the client's configuration

To modify the client's configuration:

  1. In CrossOver, select the bottle that contains your Ragnarök Online client installation.
  2. Choose BottleRun command… from the menu bar.
  3. Press Browse….
  4. Navigate to the client installation folder.
  5. If you want to modify the configuration of the Renewal client, then choose the file Setup.exe. If you want to modify the configuration of the Pre-Renewal ("Classic") client, then choose the file Setup_Classic.exe.
  6. Press Run.

Multi-clienting

To open another instance of a client while one is already open:

  1. In CrossOver, select the bottle that contains your Ragnarök Online client installation.
  2. Choose BottleOpen C: drive from the menu bar.
  3. Navigate to the client installation folder in the new Finder window that is opened.
  4. Open the file that corresponds to the type of server you want to play on:

    Server File name
    Type Name
    Renewal Chaos Ragnarok.exe
    Pre-Renewal ("Classic") Classic Loki ClassicRO.exe
    Testing Sakray Sakray.exe

Tip: Add the client installation folder to Finder's navigation pane so you can quickly open new client instances.

Tips

Increase the mouse pointer's acceleration, allow the mouse pointer to leave the client's window boundary

If you are using the Renewal client, then disable the Mouse exclusive option in the Renewal client configurator.

If you are using the Pre-Renewal ("Classic") client, then do the following:

  1. Download and then extract ROExt.
  2. In CrossOver, select the bottle that contains your Ragnarök Online client installation.
  3. Choose BottleOpen C: drive from the menu bar.
  4. In the new Finder window that is opened, navigate to the client installation folder and then move the files you extracted in step 1 (dinput.dll and dinput.ini) into the folder.
  5. In CrossOver, open Wine Configuration.
  6. Press Add application, navigate to the client installation folder, and then choose the file Ragexe.exe.
  7. Open the Libraries tab.
  8. Enter "dinput" into the New override for library field and then press Add.
  9. Return to the Applications tab.
  10. Repeat steps 7–10 for the files clragexe.exe and Sakexe.exe if they exist.
  11. Press OK.

Note: I recommend using ROExt with all of the clients because it reduces the CPU usage of a client when its window is unfocused.

Disable OS X's TCP acknowledgement delay to increase the responsiveness of gameplay

The following procedures must be performed as an OS X user that has administrative privileges.

To disable the delay:

  1. Open Terminal.
  2. Enter "sudo nano -Sw /private/etc/sysctl.conf".
  3. Enter your OS X user account password if you are prompted to.
  4. Enter "net.inet.tcp.delayed_ack=0".
  5. Press control-X, Y, and then return. (Do not press control-Y.)
  6. Enter "sudo sysctl -w net.inet.tcp.delayed_ack=0".

To reenable the delay:

  1. Open Terminal.
  2. Enter "sudo nano -Sw /private/etc/sysctl.conf".
  3. Enter your OS X user account password if you are prompted to.
  4. If the file contains multiple lines, then use the up and down arrow keys to move the cursor onto the line "net.inet.tcp.delayed_ack=0".
  5. Press control-K to delete the current line.
  6. Press control-X, Y, and then return. (Do not press control-Y.)
  7. Enter "sudo sysctl -w net.inet.tcp.delayed_ack=3".

Create guild emblems

To create a guild emblem on OS X:

  1. Download, install, and then open GIMP.
  2. Create or import an image with a resolution of 24 × 24 pixels.
  3. Choose ImageModeIndexed from the menu bar.
  4. Press Convert.
  5. Choose FileExport from the menu bar.
  6. Enter a name with the extension "bmp" and then press return.
  7. In the new window that opens, expand the Compatibility options section and then tick/check Do not write colour space information.
  8. Press Export.

Exclude the client's resource and cache files from Time Machine backups

If you back-up your data using Time Machine, then you can save space on your backup volume and shorten the duration of your backups by excluding the client's resource and cache files from being backed-up:

  1. In CrossOver, select the bottle that contains your Ragnarök Online client installation.
  2. Choose BottleOpen C: drive from the menu bar.
  3. Navigate to the client installation folder in the new Finder window that is opened.
  4. Open Terminal.
  5. Type "tmutil addexclusion " (including the space).
  6. Drag the following items from the Finder window and drop them onto the Terminal window (hold command to select multiple items):
  7. Focus the Terminal window and then press return.

Common problems and their solutions

The Sakray client updater will not open

Do the following:

  1. In CrossOver, choose ConfigureInstall software… from the menu bar.
  2. Select Run-time support componentsMicrosoft Visual C++ 6.0 Redistributable.
  3. Press Proceed and then select the bottle that contains your Ragnarök Online client installation.
  4. Press Install.
  5. Complete the installation process. Choose Yes when you are asked whether you want to restart your computer. (Your computer will not actually be restarted; CrossOver will merely simulate a restart of Windows within the bottle.)
  6. Press Done.

The updater crashes while installing updates

I have reported this problem to CodeWeavers. Unfortunately, until it is fixed, the only practical method of working around it is to reopen the updater whenever it crashes, until it finishes successfully.

The error message "SkinInfo_New.lua:219: attempt to call global `C_IsSteamOn` (a nil value)" is presented when I attempt to open the IRO client for the first time

The cause of this problem is a bug in the IRO client's updater that manifests itself when you update the client for the first time and then close the updater instead of opening the client.

To resolve this problem, do the following:

  1. In CrossOver, select the bottle that contains your Ragnarök Online client installation.
  2. Choose BottleOpen C: drive from the menu bar.
  3. Navigate to the client installation folder in the new Finder window that is opened.
  4. If the folder does not contain a file named Patchup.exe, then download this file, extract it, and then move the extracted file into the folder.
  5. Open the file Patchup.exe.

The client's graphics are distorted

Try the following potential solutions in order:

  1. Close and then reopen CrossOver.
  2. Run the command "reg add HKCU\Software\Wine\Direct3D /v OffscreenRenderingMode /d fbo" from CrossOver's Run command… window.
  3. Experiment with running the client in other video resolutions.

The error message "./AI/AI_M.lua:2: module './AI/Const.lua' not found" is presented when I attempt to use a mercenary or homunculus

  1. Download and then extract the following file:

    default-ai-system.tar.bz2
  2. In Finder, open the folder that contains the extracted files (AI).
  3. Press command-A, command-C to copy all of the items in the folder to the clipboard.
  4. In CrossOver, select the bottle that contains your Ragnarök Online client installation.
  5. Choose BottleOpen C: drive from the menu bar.
  6. Navigate to Client installation folder/AI (where Client installation folder is the path to the client installation folder).
  7. Press option-command-V to move the items you copied in step 3 into the AI folder, and replace all of the existing files. (If you are using OS X Snow Leopard or earlier, then you must instead press command-V to copy the files.)

The client runs too slowly

Unfortunately, the Ragnarök Online client does not run quite as fast under CrossOver as it does on Windows; there is a slight delay when the client loads resources. If you want to play at maximum speed, then you can install Windows on your Mac using Boot Camp.

The mouse pointer moves too slowly

See Tips.

Common questions and their answers

Is CrossOver free?

No. You can try CrossOver for free for 14 days, but you will have to purchase it if you want to continue using it after that time.

Can this guide be used to play any regional version of Ragnarök Online?

It should be possible to use this guide to successfully play any regional version of Ragnarök Online that uses a client unencumbered by anti-cheating software such as EasyAntiCheat, GameGuard, or Hackshield.

The following regional versions of the Ragnarök Online client are known to incorporate anti-cheating software:

How can I download the IRO client installer from the official source?

CrossOver 15.0.0 or later is required.

  1. Download the IRO download agent.
  2. In CrossOver, install Internet Explorer 8 into a new bottle.
  3. Choose BottleRun command from the menu bar.
  4. Choose the bottle you created in step 2.
  5. Press Browse….
  6. Choose the file you downloaded in step 1 (Ragnarok-DLM.exe).
  7. Press Run.

Can I use a custom homunculus or mercenary AI system?

Yes — see Installation: Installing extra content.

Can I use RCX?

RCX is no longer being developed and consequently is no longer compatible with the latest versions of the Ragnarök Online client.

Glossary

Bottle
A container in which CrossOver isolates different Windows applications to prevent them from conflicting with each other.
Client configurator
The application that allows you to modify the client's settings.
Client installation folder
The folder in which the Ragnarök Online client is installed.

The following are the known default installation paths of the various regional versions of the client, relative to the root of the C drive:

Region Default installation path
Europe Program Files/Gravity/Ragnarok_Europe
International Gravity/Ragnarok Online
CrossTie profile
A file that contains instructions for automating application installations with CrossOver.
ROExt
An unofficial extension to the Ragnarök Online client that adds various features, including the ability to free the mouse pointer from the client's control, reduce processor usage when the client's window is not focused, and change the parameters of the client's window.

Comments