How to play Ragnarök Online on macOS

Introduction

The IRO client running on macOSThis guide explains how to play Ragnarök Online natively on macOS using CrossOver, with a primary orientation towards the International Ragnarök Online (IRO) client.

Installation

Client

  1. If you want to play on the International server, then download the IRO client custom installer.
  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 the following:
    1. Click on Choose installer file….
    2. Choose the Ragnarök Online client installer file (International Ragnarök Online.msi).
    3. Press Continue.
  5. Press Install.
  6. Complete the installation process.
  7. Wait until CrossOver has finalised the installation, and then press Done.

Components and extensions

AzzyAI

To install AzzyAI:

  1. Install Microsoft .NET Framework 4.7.2 (or a later version) into the bottle that contains your Ragnarök Online client installation.
  2. Download and then extract AzzyAI.
  3. In CrossOver, select the bottle that contains your Ragnarök Online client installation.
  4. Choose BottleOpen C: drive from the menubar.
  5. Navigate to Client installation folder/AI/USER_AI (where Client installation folder is the path to the client installation folder).
  6. Move the contents of the folder that you extracted in step 2 into the current folder.
  7. If you are not using the International Ragnarök Online client, then open the client and enter the commands "/merai" and "/hoai" to delegate control of your mercenaries and homunculi to AzzyAI.

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 menubar.
  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.

ROExt

  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 menubar.
  4. Navigate to the client installation folder.
  5. Move the files dinput.asi and dinput.ini, which you extracted on step 1, into the current folder.
  6. In CrossOver, open Wine Configuration.
  7. Press Add application, navigate to the client installation folder, and then choose the file Ragexe.exe.
  8. Open the Libraries tab.
  9. Enter "dinput" into the New override for library field, and then press Add.
  10. Return to the Applications tab.
  11. Repeat steps 7–10 for the file Sakexe.exe.
  12. Press OK.

SimpleROHook

  1. Download and then extract SimpleROHook.
  2. In CrossOver, install Microsoft .NET Framework 4.7.2 (or a later version) and Microsoft Visual C++ 2015 Redistributable (32-bit) 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.)
  3. Choose BottleOpen C: drive from the menubar.
  4. Navigate to the client installation folder.
  5. Move the folder that you extracted in step 1 into the current folder.

Configuration

Keyboard

On standard Mac keyboards (those without a touch bar), most or all of the function keys 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 fn while pressing the function keys to control applications, but this is impractical while playing games. On keyboards with a touch bar, the function keys are only displayed on the touch bar while holding fn. Therefore, if you want control the client with the function keys, then you should do the following before playing Ragnarök Online:

To make the function keys accessible:

If you have a standard keyboard:
  1. Open System Preferences.
  2. Choose Keyboard.
  3. Open the Keyboard tab.
  4. Enable the option Use all F1, F2, etc. keys as standard function keys.
If you have a keyboard with a touch bar:
  1. Open System Preferences.
  2. Choose Keyboard.
  3. Open the Keyboard tab.
  4. Set Touch bar shows to F1, F2, etc. keys.

To modify or disable conflicting macOS key mappings:

  1. In System Preferences, press commandL.
  2. Choose Mission Control.
  3. Change the Show desktop and Show Dashboard shortcuts to controlF11 and controlF12 respectively, or disable them. (Hold control to use it as a modifier.)

Client

To modify the client's video resolution:

If you installed the client with the custom installer:
  1. In CrossOver, select the bottle that contains your Ragnarök Online client installation.
  2. Open Configuration (Renewal).
If you installed the client with the official installer:
  1. In CrossOver, select the bottle that contains your Ragnarök Online client installation.
  2. Choose BottleRun command… from the menubar.
  3. Press Browse….
  4. Navigate to the client installation folder.
  5. Choose the file Setup.exe.
  6. Press Run.

To modify the configuration of the client's graphics, audio, or key mappings:

  1. In the client, expand the window that displays your character's current levels and so on.
  2. Click on Options, which is situated below the window.

Usage

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 menubar.
  3. Navigate to the client installation folder.
  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
    Testing Sakray Sakray.exe

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

Tips

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

To disable the delay:

  1. Open Terminal.
  2. Enter the following:

    sudo nano -Sw /etc/sysctl.conf
  3. Enter your macOS user account password if you are prompted to.
  4. Type the following:

    net.inet.tcp.delayed_ack=0
  5. Press controlX, Y, and then return. (Do not press controlY.)
  6. Enter the following:

    sudo sysctl -w net.inet.tcp.delayed_ack=0

To reenable the delay:

  1. Open Terminal.
  2. Enter the following:

    sudo nano -Sw /etc/sysctl.conf
  3. Enter your macOS 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 controlK to delete the current line.
  6. Press controlX, Y, and then return. (Do not press controlY.)
  7. Enter the following:

    sudo sysctl -w net.inet.tcp.delayed_ack=3

Create guild emblems

To create a guild emblem on macOS:

  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 menubar.
  4. Press Convert.
  5. Choose FileExport from the menubar.
  6. Enter a name with the extension "bmp", and then press return.
  7. Enable the following options:

    Compatibility optionsDo not write colour space information
    Advanced options24 bits: R8 G8 B8
  8. Press Export.

Exclude CrossOver and 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 CrossOver and the client's resource and cache files from being backed-up:

  1. Open Terminal.
  2. Enter the following:

    /usr/bin/find -E "${HOME}/Library/Application Support/CrossOver/Bottles" \
    \( \
    \( \
    -type f \
    -iname '*.grf' -or \
    -name notice_patch.txt -or \
    -name patch_allow.txt -or \
    -iregex '.*/(c|re|s)?patch[[:digit:]]?\.txt' \
    \) -or \
    \( \
    -type d \
    -name _tmpEmblem -or \
    -regex '.*/drive_c/users/crossover/(Local Settings/Temporary Internet Files|Temp)' \
    \) \
    \) \
    -exec /usr/bin/tmutil addexclusion {} +

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. If you do not want to purchase CrossOver, then try using Wine, a free alternative to CrossOver.

How do I select a bottle?

To show the bottle list:

  1. In CrossOver, press optioncommand0 to open the bottle manager.
  2. Choose ViewShow bottles from the menubar.

Can I play on the International Pre-Renewal (Classic) server?

The Classic server was closed on 11 July 2019.

Can I use a custom homunculus or mercenary AI system?

Yes: see Installation: Components and extensions: AzzyAI.

Common problems and their solutions

The client does not open

Unfortunately, the following regional versions of the Ragnarök Online client are not compatible with Wine because they incorporate anti-cheating software such as CheatDefender, EasyAntiCheat, GameGuard, or Hackshield:

The Sakray client updater will not open

  1. In CrossOver, select the bottle that contains your Ragnarök Online client installation.
  2. Open Wine Configuration.
  3. Set Windows version to Windows Vista.
  4. Press OK.
  5. Install Microsoft Visual C++ 6.0 Redistributable into the bottle that contains your Ragnarök Online client installation. 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.)

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 pressing Play.

To resolve this problem, do the following:

  1. Download and then extract the following file:

    Renewal client updater.zip
  2. In CrossOver, select the bottle that contains your Ragnarök Online client installation.
  3. Choose BottleOpen C: drive from the menubar.
  4. Navigate to the client installation folder.
  5. Move the file that you extracted in step 1 (Ragnarok.exe) into the current folder, and then press Replace.

The client permanently displays a black screen after upgrading to CrossOver 17.0.0

  1. In CrossOver, select the bottle that contains your Ragnarök Online client installation.
  2. Choose BottleRun command… from the menubar.
  3. Enter the following into the Command field:

    reg delete HKCU\Software\Wine\Direct3D /v OffscreenRenderingMode /f
  4. Press Run.

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 CrossOver, select the bottle that contains your Ragnarök Online client installation.
  3. Choose BottleOpen C: drive from the menubar.
  4. Navigate to Client installation folder/AI (where Client installation folder is the path to the client installation folder).
  5. Move the contents of the folder that you extracted in step 1 (AI) into the current folder, and then replace all of the existing files.

The mouse pointer is difficult or impossible to control

If you are using macOS Mojave (10.14) or later, then ensure that CrossOver has permission to control the mouse pointer:

  1. Open System Preferences.
  2. Choose Security & Privacy.
  3. Open the Privacy tab.
  4. Select Accessibility in the list that is situated on the left.
  5. Ensure that wine-preloader is enabled in the list that is situated on the right.

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.

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.
CrossTie profile
A file that contains instructions for automating application installations with CrossOver.
Focus
Move a window to the front so that it can receive keyboard input.
Function keys
The keys labelled "F1–19". On standard keyboards, the keys are situated on the top row; on keyboards with a touch bar, the keys are displayed on the touch bar while holding fn.
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