Guide for MAC [NEW] MacOS Installation Guide & FAQ

MapleLegends for MacOS comes in three forms: Crossover, Wineskin, and VMware/Parallels. Please check the relevant section. To know which MacOS you're on, please click the Apple icon on the top left of your screen. Click "about this Mac". If you would like to not run through Crossover/Wineskin, you can install through VMware

CROSSOVER
WORKS on MacOS 10.13 and higher (includes Catalina & Big Sur)
SOMETIMES WORKS on M1/ARM products (Macbook 2020+)
DOES NOT work on Sierra or lower (MacOS 10.12 or lower)

Spoiler: Crossover

How to Install

Spoiler

1. Download the latest MapleLegends Client (Crossover) here.

2. Install Crossover based on MacOS version:
You can find your MacOS version by clicking the top left Apple icon and selecting About This Mac

Spoiler: Catalina - Big Sur

Download & install Crossover 20.0.4 from here.

Spoiler: Monterey +

Download & install Crossover 21.0.0 from here.

If you are prompted with a "Files have to be downloaded to support this version", click okay and proceed with the installation. Thanks to Floris for figuring this out.
(Don't need to put in your real details)
We recommend buying this product here https://www.codeweavers.com/store, as it's cheaper than buying a Windows OS for Parallels/Bootcamp.
However, if you don't want to, there is a way to extend the trial period below.

3. Go to your application folder, find Crossover and right click and press 'open'.
DO NOT double click.

4. Press Command + O and open MapleLegends.

5. You should be able to launch MapleLegends now!

[OPTIONAL] Apparently disabling "Performance Enhanced Graphics"
in Crossover allows for smoother frame rates & less lag.
Additionally, playing fullscreen helps too with CPU usage.

Spoiler: EXTENDING the trial period

EXTENDING the Trial Period

Code:

1. Launch Crossover at least once, then close it.

2. Download PlistEdit Pro from https://www.fatcatsoftware.com/plisteditpro/

3. Open your Home folder: Macintosh HD⁩ ▸ ⁨Users⁩ ▸ ⁨[insert user]

4. Press Command + Shift + G and type:
library/preferences

4. Open "com.codeweavers.CrossOver.plist" with PlistEdit.

5. Change "FirstRunDate" to sometime in the wayyy future, then save it.

6. Your trial period is extended!

Game Doesn't Launch!

Spoiler

If you've followed all the steps above, make sure you're on CROSSOVER 20, and if the game still doesn't launch please try:

[SOLUTION 1] If you crash right after the logo/animations, install the following:
https://drive.google.com/file/d/1KsJ7dQ-wcAJ_VD6fF-QHM-op3bf9KH89/view?usp=sharing

[SOLUTION 2] Open "System Preferences" > "Security & Privacy" > "Privacy" >
"Full Disk Access" > Add Crossover using the + icon:



[SOLUTION 3] If it does not launch, you have an anti-virus.
Please follow the instructions here:
https://www.codeweavers.com/support/wiki/mac/mactutorial/bitdefender

[SOLUTION 4] Please delete Crossover. Then disable your anti-virus.
Reinstall Crossover & MapleLegends. Then repeat Solution 1 & 2.
Once you confirm MapleLegends to be running, you can re-enable your anti-virus.

How to Multi Client

Spoiler

1. Open Crossover.

2. Right click MapleLegends, press "show in finder".

3. Duplicate the MapleLegends program as many times as you want.

4. Launch MapleLegends!

How to Change Settings (Resolution, Dark Chat, Etc)

Spoiler

1. Open Crossover.

2. Click the bottom left gear icon, and "open drive_c".

3. Go to the MapleLegends folder.

4. Open Legends.ini with TextEdit and make the appropriate changes.

5. Save the file, and launch MapleLegends.

Read/Type Other Languages

Spoiler

1. Open Crossover.

2. Click the bottom left gear icon, and "open drive_c".

3. Go to the folder ABOVE "drive_c", by pressing Command + Up.

4. Open cxbottle.conf with TextEdit.

5. Scroll to the very bottom and change "LANG" = "xx_xx.UTF-8".

For Korean: replace "xx_xx" with "ko_KR"
For simplified Chinese: replace "xx_xx" with "zh_CN"
For traditional Chinese: replace "xx_xx" with "zh_TW"
For Japanese: replace "xx_xx" with "ja_JP"

Codes for other languages can be found here.

Code:

For example, if you were to change it to Korean, it should read:
"LANG" = "ko_KR.UTF-8"

6. Back in Crossover, right click the MapleLegends bottle and click
"Install Software into "MapleLegends""



7. Search for "Asian Font Component" and install it into your bottle.



8. Launch the game!

Bottle Expired

Spoiler: Deleting .eval File

1. Open Crossover, and right click the MapleLegends bottle and click "open c_drive".
2. Navigate to MapleLegends folder
3. Run BottleExpired.app

WINESKIN
DOES NOT work on Catalina or higher (MacOS 10.15+)
DOES NOT work on M1/ARM products (Macbook 2020+)
WORKS on El Capitan, Sierra, High Sierra, Mojave (MacOS 10.11 - 10.14)

Spoiler: Wineskin

How to Install

Spoiler

1. Download the latest MapleLegends Client (Wineskin) here.

2. In your downloads folder, right click and press 'open' on the MapleLegends.pkg.

3.Go to your applications folder and right click, show package contents on MapleLegends.app.

4. Open "Wineskin".

5. Go to advanced > tools > refresh wrapper.



5. Exit Wineskin, then click "Play MapleLegends".

5. Your game should be running smoothly!

Client Does Not Pop Up When Launching

Spoiler

Spoiler: SOLUTION #1: Refresh Wrapper

A) Open up your Activity Monitor, and quit all processes called Maple, xQuartz, Wine, Wineskin

B) Go to your applications folder and right click, show package contents on MapleLegends.app.

C) Open "Wineskin".

D) Go to advanced > tools > refresh wrapper.

E) Exit "Wineskin" and go back and press "Play MapleLegends"

Spoiler: SOLUTION #2: Granting Permission

[System Preference Method*]
Open "System Preferences" > "Security & Privacy" > "Privacy" >
"Full Disk Access" > Add Crossover using the + icon:



[Terminal Method]
A) Open Wineskin again, and in "set screen options" try toggling the use Mac Driver/X11 setting.

B) Grant your user account permissions to run MapleLegends:

Code:

1. Open the Terminal application (black/white box)

2. Type in "sudo chown -R $USER: /Applications/MapleLegends.app/Contents/Resources"

3. Enter in your password for your computer and press enter.
You will not see it being typed out for security reasons.

4. Once finished, try pressing "Play MapleLegends"

Spoiler: SOLUTION #3: Toggle X11/Mac Driver

A) Open Wineskin

B) In "set screen options" try toggling the use Mac Driver/X11 setting.
This works for some people. Breaks for others. Stick with the setting that lets you at least launch the game.

Client Launches, But Crashes After Neckson/Wizet Logo

Spoiler

1. Download xQuartz from here.

2. Install it

3. Launch the game again this should fix it along with any other broken fonts you may have had before (if you had any).

How to Multi Client

Spoiler

There is no need to duplicate your MapleLegends.app anymore!

1. Go to your applications folder and right click, show package contents on MapleLegends.app.

2. Click "Play MapleLegends"

3. Click "Play MapleLegends" again. Tada!

How to Change Settings (Resolution, Dark Chat, Etc)

Spoiler

1. Go to your applications folder and right click, show package contents on MapleLegends.app.

2. Open "drive_c"

3. Go to the MapleLegends folder

4. Open Legends.ini with TextEdit and make the appropriate changes.

5. Save the file, and launch MapleLegends.

Read/Type Other Languages

Spoiler

1. Go to your applications folder and right click, show package contents on MapleLegends.app.

2. Open "Wineskin"

3. Click advanced and put in ONE of the lines below in custom commands:

Code:

export LANG=ko_KR.UTF-8

export LANG=zh_CN.UTF-8

export LANG=zh_TW.UTF-8

export LANG=ja_JP.UTF-8

4. Exit "Wineskin" and go back and press "Play MapleLegends"

VMware Fusion
Untested on Catalina or higher (MacOS 10.15+)
Works on M1/ARM products (Macbook 2020+)
Untested on El Capitan, Sierra, High Sierra, Mojave (MacOS 10.11 - 10.14)

Spoiler: VMware Fusion

If the other options aren't working, VMware/Parallels will emulate a Windows operating virtual machine and you can install the WINDOWS version of MapleLegends
Install link here

Frequently Asked Questions

Q: The moment I login, I crash!
A: Please get the latest patch here.

Q: How do I disable "Command+Enter" full screen on Mac since that freezes the game?
A: Follow the steps here.

Q: I logged in successfully, but when I click my character I crash!
A: Select your character and press "enter" on your keyboard.
OR Do not select a world, pressing "view all characters" and enter using your mouse.

OR Restart your computer.

OR (if Crossover) Turn your Performance Enhance Graphics option back on.

If you have any MacOS related issues, please tell us by using the following format:

Spoiler: READ ME

~~~~~~~~~~~~~~~~~~~~~~~~
Client: Crossover/Wineskin
MacOS version: Mojave/Catalina/Big Sur/etc
Describe the error:
Last Run Log:
For Crossover, you can find this by "Run with option"

Spoiler

For Wineskin, you can find this by "Test Run" in Wineskin > Advance
~~~~~~~~~~~~~~~~~~~~~~~~

 

You could try to disable the following (uncheck it):



It lowers the CPU usage, and should apparently result in smoother frame rate too

 

Have you tried the "Game Doesn't Launch" solutions 1 & 2?

 

For future reference, which solution helped you out? ^^

 

Someone on our discord #support just mentioned he had the same issue, but managed to fix it by trying to enter different channels. Original post edited to include this information as well!

 

Which version are you on?