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.

  1. Nise
    Offline

    Nise Supervisor Staff Member Supervisor Game Moderator

    2,059
    693
    500
    Jul 5, 2017
    Male
    Korea
    3:56 AM
    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: Feb 28, 2024
    • Great Work Great Work x 16
    • Like Like x 3
    • Informative Informative x 1
    • Friendly Friendly x 1
  2. Motto
    Offline

    Motto Skelegon

    1,068
    1,139
    428
    Jun 30, 2018
    Male
    Mars
    7:56 PM
    PogShad Motto
    Islander
    201
    Me having no more excuses to get an M1, but might way for the M1X chip this autumn.
    [​IMG]

    As always, great job on the find and new ways to play on new versions.

    Long live !mac
     
    • Funny Funny x 1
  3. Voxtagrams
    Offline

    Voxtagrams Headless Horseman

    885
    381
    376
    Jun 13, 2020
    11:56 AM
    Whoa, this is sooooo Nise! (No pun intended.)

    The Legendary Tomayter has spoken!

    I should also get a new mac.. lol
     
  4. Floris
    Offline

    Floris Capt. Latanica

    367
    261
    273
    May 27, 2020
    Male
    7:56 PM
    Just realised this is already marked as 'unstable on mac', whoops ~
    This is awesome Nise!
    One issue I am running into is the classic 'Failed in finding proper screen mode for Gr2D' error when trying to play the client on the 1366x768 setting. Otherwise 1024x768 works lovely, thank you so much <3

    upload_2021-3-16_11-43-8.png

    That one f3

    EDIT: btw this is running a M1 macbook air, might be the new screens that have unmatching resolutions or w/e.
     
  5. Kimmy
    Offline

    Kimmy Administrator Staff Member Administrator Game Moderator

    10,963
    10,998
    551
    Sep 9, 2014
    The Netherlands
    7:56 PM
    Moderator Post
    HD2 still does not work naturally on MAC unfortunately
     
    • Friendly Friendly x 1
  6. Huiae
    Offline

    Huiae Headless Horseman

    890
    865
    386
    Aug 1, 2015
    Female
    Seoul, Korea
    3:56 AM
    Verdict
    Bishop
    WeenieHutJrs
    This error occurs when your graphic card doesn't support resolution you've set.
    Unfortunately, seems virtual graphic card which set in mac ML client (yes, mac ML client is based on virtual machine, which uses virtual graphic card) doesn't support resolution beside option 1.

    This can be solved when VM graphic card supports 800x600 or 1366x768 in future but this is out of hands of ML staff team. it's on hands of mac developers. let's just hope this issue gets solved asap. :)

    Wish this shines a light for your understanding about issue.
     
    • Great Work Great Work x 1
  7. anderskf
    Offline

    anderskf Blue Snail

    4
    0
    22
    Sep 27, 2020
    Male
    7:56 PM
    BustyBroad
    Night Lord
    Thanks a lot for the solution - it seems to work perfectly!

    I was wondering if you know if it is possible to limit the CPU power used on a Mac? Similar to the power plan/settings you can change in Windows where you set a maximum processor state. Or if you can delegate less CPU power to Crossover? My 2020 Macbook Pro gets hot as hell when running Maple
     
  8. OP
    OP
    Nise
    Offline

    Nise Supervisor Staff Member Supervisor Game Moderator

    2,059
    693
    500
    Jul 5, 2017
    Male
    Korea
    3:56 AM
    NoraONE
    Corsair
    189
    Sweetdreams
    You could try to disable the following (uncheck it):

    [​IMG]

    It lowers the CPU usage, and should apparently result in smoother frame rate too :eek:
     
    • Great Work Great Work x 1
    • Informative Informative x 1
  9. Lily640
    Offline

    Lily640 Blue Snail

    2
    0
    2
    Mar 16, 2021
    Female
    11:56 AM
    Hello! I've been trying to install the game on Mac with Crossover, and all went well until I tried to install the game and got an error saying "Runtime Error (at -1:0): Cannot import dll:C:\users\crossover\Temp\isMHK2R.tmp\isskin.dll."

    Does anyone know what this means and how I can fix it? Thanks!
     
  10. OP
    OP
    Nise
    Offline

    Nise Supervisor Staff Member Supervisor Game Moderator

    2,059
    693
    500
    Jul 5, 2017
    Male
    Korea
    3:56 AM
    NoraONE
    Corsair
    189
    Sweetdreams
    Have you tried the "Game Doesn't Launch" solutions 1 & 2?
     
  11. Lily640
    Offline

    Lily640 Blue Snail

    2
    0
    2
    Mar 16, 2021
    Female
    11:56 AM
    I got it to work now, thank you!
     
  12. OP
    OP
    Nise
    Offline

    Nise Supervisor Staff Member Supervisor Game Moderator

    2,059
    693
    500
    Jul 5, 2017
    Male
    Korea
    3:56 AM
    NoraONE
    Corsair
    189
    Sweetdreams
    For future reference, which solution helped you out? ^^
     
    • Like Like x 1
  13. Shawker
    Offline

    Shawker Snail

    1
    0
    0
    Mar 17, 2021
    Male
    11:56 AM
    Shawker
    Beginner
    I'm running into issues when try to select character from either "view all characters" or the original way:
    Platform: M1 Macbook with Big Sur
    Repro:
    Clicked on CrossOver
    Open MapleLegends Archive
    Opens Maplestory
    Login
    Freezes at either entry into game
     
    • Agree Agree x 1
  14. OP
    OP
    Nise
    Offline

    Nise Supervisor Staff Member Supervisor Game Moderator

    2,059
    693
    500
    Jul 5, 2017
    Male
    Korea
    3:56 AM
    NoraONE
    Corsair
    189
    Sweetdreams
    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!
     
    • Friendly Friendly x 1
  15. Bax
    Offline

    Bax Orange Mushroom

    36
    10
    43
    Nov 30, 2020
    Male
    2:56 AM
    Paragax; Qishop
    Marksman
    180
    Perion
    Long Live NISE
     
    • Friendly Friendly x 4
  16. Motto
    Offline

    Motto Skelegon

    1,068
    1,139
    428
    Jun 30, 2018
    Male
    Mars
    7:56 PM
    PogShad Motto
    Islander
    201
    I'm interested in this, for running more than 4 clients.

    My late 2013 struggles with 4 (sounds like a jet engine and chugs when opening discord)
    So if the M1 actually works with more than 4... I'm all in.

    LF> multiclient testers to try out running a lot of clients
     
  17. Floris
    Offline

    Floris Capt. Latanica

    367
    261
    273
    May 27, 2020
    Male
    7:56 PM
    This drastically lowered the CPU usage for me, to the point where I was smoothly able to run 11 separate MapleLegends clients on my M1 macbook air with 7c GPU and watch a youtube video at the same time. The clients are all 1024x768 and graphics settings on highest.

    https://imgur.com/gnwYfIT
    https://imgur.com/xilbQsR
    upload_2021-3-17_18-5-53.png

    upload_2021-3-17_18-6-0.png

    I let the clients sit for longer than it would take for my macbook air (without a fan) to thermal throttle (over 20 mins).
    Just imagine how many 800x600 clients on low graphics settings u could run LOL.

    So; Thank you so so much Nise and ML staff for making this happen, you guys are the best <3

    Also MottoMotto made me post this so blame him
     
    • Friendly Friendly x 2
  18. oohyoo
    Offline

    oohyoo Horny Mushroom

    40
    6
    51
    Mar 3, 2018
    Female
    2:56 PM
    sunjoo/sappho
    my client freezes too when I select my character at login.. I tried both recommended methods and unfortunately neither are working :( I'm playing on a 2020 Macbook Pro using Big Sur
     
    • Agree Agree x 1
  19. Siggy
    Offline

    Siggy Slimy

    237
    56
    231
    Jun 12, 2017
    Male
    California
    11:56 AM
    Client not opening at all after trying each step :(
     
  20. OP
    OP
    Nise
    Offline

    Nise Supervisor Staff Member Supervisor Game Moderator

    2,059
    693
    500
    Jul 5, 2017
    Male
    Korea
    3:56 AM
    NoraONE
    Corsair
    189
    Sweetdreams
    Which version are you on?
     

Share This Page