1. Hello!

    First of all, welcome to MapleLegends! You are currently viewing the forums as a guest, so you can only view the first post of every topic. We highly recommend registering so you can be part of our community.

    By registering to our forums you can introduce yourself and make your first friends, talk in the shoutbox, contribute, and much more!

    This process only takes a few minutes and you can always decide to lurk even after!

    - MapleLegends Administration-
  2. Experiencing disconnecting after inserting your login info? Make sure you are on the latest MapleLegends version. The current latest version is found by clicking here.
    Dismiss Notice

Guide for MAC [NEW] MacOS Installation Guide & FAQ

Discussion in 'Technical Issues' started by Nise, Mar 16, 2021.

Thread Status:
You must be a logged-in, registered member of this site to view further posts in this thread.
  1. Nise
    Offline

    Nise Supervisor Staff Member Supervisor Game Moderator

    2,059
    699
    500
    Jul 5, 2017
    Male
    Korea
    7:33 PM
    NoraONE
    Corsair
    189
    Sweetdreams
    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

    [​IMG] 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)

    [​IMG] How to Install [​IMG]
    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
    Download & install Crossover 20.0.4 from here.
    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 FlorisFloris 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.

    [​IMG]

    [​IMG] EXTENDING the Trial Period [​IMG]
    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!

    [​IMG]Game Doesn't Launch![​IMG]
    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:

    [​IMG]

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

    :health: How to Multi Client :health:
    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!

    [​IMG]

    :mana: How to Change Settings (Resolution, Dark Chat, Etc) :mana:
    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.

    [​IMG]

    [​IMG] Read/Type Other Languages [​IMG]
    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"
    [​IMG]

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

    [​IMG]

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

    [​IMG]

    8. Launch the game!

    [​IMG]Bottle Expired[​IMG]
    1. Open Crossover, and right click the MapleLegends bottle and click "open c_drive".
    2. Navigate to MapleLegends folder
    3. Run BottleExpired.app

    [​IMG]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)

    [​IMG] How to Install[​IMG]
    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.

    [​IMG]

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

    5. Your game should be running smoothly!

    [​IMG] Client Does Not Pop Up When Launching [​IMG]
    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"

    [​IMG]

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

    [​IMG]

    [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"

    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.

    [​IMG] Client Launches, But Crashes After Neckson/Wizet Logo [​IMG]
    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).

    :health: How to Multi Client :health:
    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!

    [​IMG]

    :mana: How to Change Settings (Resolution, Dark Chat, Etc) :mana:
    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.

    [​IMG] Read/Type Other Languages [​IMG]
    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"

    [​IMG] 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)

    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



    Foxpat 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:
    ~~~~~~~~~~~~~~~~~~~~~~~~
    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"
    [​IMG]
    For Wineskin, you can find this by "Test Run" in Wineskin > Advance
    ~~~~~~~~~~~~~~~~~~~~~~~~
     
    Last edited by a moderator: Aug 5, 2024
    • Great Work Great Work x 16
    • Like Like x 3
    • Informative Informative x 1
    • Friendly Friendly x 1
Thread Status:
You must be a logged-in, registered member of this site to view further posts in this thread.

Share This Page