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

MapleLegends Unofficial Linux Client

Discussion in 'Guides' started by Brickfist, Apr 11, 2026.

  1. Brickfist
    Offline

    Brickfist QA Tester Staff Member QA Tester

    5
    0
    5
    May 21, 2025
    Male
    2:49 PM
    Brickfist
    Priest
    70
    WeenieHutJrs
    There's been a greater number of players coming by asking for help with Linux and Cak33Cak33 asked me to compile a more easy to use guide using their scripts.

    The following guide will have step by step instructions as well as screenshots of every step of the way. You do not need to have extensive knowledge of Linux to get this working (I myself am a novice and had no issue.) As this is not my scripts and I'm merely compiling the guide, I will not be able to provide support on issues.

    A preface from the original thread:
    That all being said, let's get started!

    Step 1: Download The Scripts:
    Download the scripts from this link and extract the files somewhere on your PC.
    Once extracted, you should have a folder with the following content in it:
    [​IMG]

    Step 2: Ensure the Files Can Be Ran as Executables:
    By default, the scripts may not be allowed by your OS to be ran as an executable. This is easily fixed by doing the following:

    1) Right click the file in question and select Properties
    [​IMG]
    2) In the window that appears, click the Permissions tab at the top and click the check box that says "Allow executing file as program"
    [​IMG]
    3) Click OK at the bottom. Repeat for each .sh file to ensure they are all permitted to be executed.

    4) In the AppImages folder, ensure all three .AppImage files have the same permissions allowed.
    [​IMG]

    Step 3: Download MapleLegends Client:
    1) Navigate to the latest version thread and download the Crossover client.

    Note: Both Crossover and Winskin will work, but only Crossover will work with the included scripts. If you wish to manually patch with the Wineskin version, you just need to unpack and replace the ./MapleLegends folder with the folder from the newest MAC client. For the sake of this guide, we will proceed with using Crossover specifically.

    2) Once downloaded, you will receive a .cxarchive file. Drop this into your folder where you have your scripts saved.
    [​IMG]
    Step 4: Install MapleLegends
    1) Double click client_settings.sh
    2) In the window that appears, ensure "Install/Update MapleLegends" is selected and click OK
    [​IMG]
    3) In the new window that appears, navigate to the folder you saved the .cxarchive in and select it. Click the OK button in the top right corner.
    [​IMG]
    3.a) A warning will appear notifying you that any existing install of MapleLegends will be deleted. If this is your first time installing, you can safely ignore this and click Yes. Otherwise, back up any files you may want (like your Legends.ini file, for instance.)
    [​IMG]
    3.b) After clicking Yes, a notification will appear telling you that extraction will commence once you click OK. Click OK to begin the process. Another notification will appear once it has completed.
    Step 5: Play the Game!
    If you've done everything correctly and Murphy has not cursed you with his Law, then the game should be ready to play!

    In order to run the game, run maplelegends.sh and it should automatically start a MapleLegends client.

    If you wish to edit your Legends.ini file, simply select the option from the client_settings.sh file.



    Troubleshooting:

    Gr2D Error:
    [​IMG]
    To fix this error, edit your Legends.ini file and change HDClient= to 0 or 1. HDClient=2 is not stable on the Mac version of the client and will generally give you this error.

    If the problem persists after this, run maplelegends_windowed.sh instead.

    Steam Deck:

    Steam Deck users can access the game in either game mode or desktop mode.

    If you are using game mode, launch maplelegends.sh (This can also be added into game mode as a separate game)

    If you are using desktop mode, launch maplelegends_windowed.sh


    Game Does Not Launch

    If you run maplelegends.sh and it does not load the game, attempt the following steps to fix your issue:

    1) Remake the prefix using client_settings.sh
    [​IMG]
    Clicking OK will display a warning that your current prefix (if any) will be deleted. Click OK.

    2) Try setting HDClient=0. There haven't been any known reports of HDClient=1 causing issues, but this would be a safe troubleshooting step regardless.

    3) Try running maplelegends_windowed.sh

    4) If still not launching, open client_settings.sh and Install dxvk-sarek v1.11.0
    [​IMG]

    5) If this still doesn't work for you, open client_settings.sh again and Install dxvk v2.71
    [​IMG]



    And that's it! Thanks again to Cak33Cak33 for supplying these wonderful scripts to the streamline the process.
    If you have any question at all regarding weirdness with Linux, feel free to ask in the Support channel in the Discord, as there's a fair number of avid Linux users active.
     
    • Great Work Great Work x 5
    • Friendly Friendly x 1
    • Useful Useful x 1
  2. Cak33
    Offline

    Cak33 Skelegon

    1,060
    363
    398
    Oct 24, 2019
    Male
    3:49 AM
    NotCut3
    Hero
    172
    Active
    big thanks to BrickfistBrickfist for writing the guide and testing

    also big thanks to creativecreative cl_ogar0cl_ogar0 MysticalMystical and many others who helped out with the test (apologies if i left out your names)

    Mega big thanks to pkgforge for helping me out to create a wine appimage, with direct support from them. They also provided zenity (for UI) and text editor (for editing legends.ini) appimages
    https://github.com/pkgforge-dev/

    and additional acknowledgement to dxvk-sarek and dxvk developers for optional compatibility
    https://github.com/pythonlover02/dxvk-Sarek
    https://github.com/doitsujin/dxvk/
     
    Last edited: Apr 11, 2026
    • Great Work Great Work x 3
    • Useful Useful x 1
  3. ItzLeo
    Offline

    ItzLeo Pink Bean

    4,538
    707
    500
    Jun 16, 2021
    Male
    Rio grande do Sul - BR
    4:49 PM
    ItzLeo
    Paladin
    200
    Favela
    Wow, this is going down in online game history xD
     
    • Friendly Friendly x 1
  4. creative
    Offline

    creative Nightshadow

    691
    3,958
    410
    Nov 2, 2019
    Male
    3:49 PM
    I will give this a try and report back my findings as I'm using Conty instead of what you guys are using.

    Update as of 8:40PM ET (2:40AM ST)
    Installing this way was definitely easier which was cool to see which I highly appreciate. Downloading the Crossover version and then having it install the files was very helpful and surprisingly quicker than on Windows. When I first ran the non-windowed client, I got the GR2D error and tried out the windowed client which worked fine. I went back to use the windowed client and got the error that I've mentioned to Cak33Cak33 about how my mouse is stuck on a box of some sort and can't get out of it unless I ALT + TAB to another widow to close it.

    Would it be something I use in the future? Of course! At this moment? Not until we get that sorted out with my mouse. For now, I'll stick with using Conty til that gets sorted out. I have the video of what happens that I sent to Cak if you'd like me to DM it to you.
     
    Last edited: Apr 12, 2026
  5. cl_ogar0
    Offline

    cl_ogar0 Wolfspider

    548
    43
    320
    Nov 1, 2024
    Male
    9:49 PM
    [​IMG]

    question, if i use those scripts for updating the client easier, will it save my .ini settings?
     
    Last edited: Apr 11, 2026
  6. Cak33
    Offline

    Cak33 Skelegon

    1,060
    363
    398
    Oct 24, 2019
    Male
    3:49 AM
    NotCut3
    Hero
    172
    Active
    nope xD
     
  7. cl_ogar0
    Offline

    cl_ogar0 Wolfspider

    548
    43
    320
    Nov 1, 2024
    Male
    9:49 PM
    i guess it can be done manually, not a big deal
     
    • Friendly Friendly x 1
  8. Hrar
    Offline

    Hrar Stone Golem

    119
    37
    135
    Jun 15, 2024
    Male
    4:49 PM
    Qiria
    Hunter
    I would say that this form of playing on Linux is the best one I tried ever.

    Thanks for keeping it updated, I hope to get into the server soon (right now I'm on a hiatus).
     
  9. creative
    Offline

    creative Nightshadow

    691
    3,958
    410
    Nov 2, 2019
    Male
    3:49 PM
    Updated my original post with my findings

     
  10. cl_ogar0
    Offline

    cl_ogar0 Wolfspider

    548
    43
    320
    Nov 1, 2024
    Male
    9:49 PM
    Im not 100% sure but i think it has to do with virtual desktop setting resolution
     
  11. creative
    Offline

    creative Nightshadow

    691
    3,958
    410
    Nov 2, 2019
    Male
    3:49 PM
    I changed the resolution with winecfg to be HD 1 size and it gave me the same problem.
     
  12. Hrar
    Offline

    Hrar Stone Golem

    119
    37
    135
    Jun 15, 2024
    Male
    4:49 PM
    Qiria
    Hunter
    I could make work the 1366x768 client but it doubles the windows (Wine desktop and also the client)
    I made the changes on the wine.cfg.
    Here a photo:
    [​IMG]

    EDIT:
    I could make work somehow the 1366 resoultion into the first maplelegends.sh with that fix I did, if someone could double check for it (On desktop).
     
    Last edited: Apr 12, 2026
  13. cl_ogar0
    Offline

    cl_ogar0 Wolfspider

    548
    43
    320
    Nov 1, 2024
    Male
    9:49 PM
    Now try if you can right click on the bar on top of window and put it on fullscreen (if you so wish)
     
  14. Cak33
    Offline

    Cak33 Skelegon

    1,060
    363
    398
    Oct 24, 2019
    Male
    3:49 AM
    NotCut3
    Hero
    172
    Active
    can you try this?
    1. enable virtual desktop
    2. set some resolution (1366x768 for eg)
    3. apply
    4. disable virtual desktop. ensire 1366x768 is still written inside resolution.
    5. apply
    6. launch maplelegends_windowed.sh

    i remembered this worked for me, but somehow slipped off my mind
     
    • Great Work Great Work x 1
  15. Hrar
    Offline

    Hrar Stone Golem

    119
    37
    135
    Jun 15, 2024
    Male
    4:49 PM
    Qiria
    Hunter
    Works perfectly, thanks again Cak33!
     
    • Friendly Friendly x 1
  16. cl_ogar0
    Offline

    cl_ogar0 Wolfspider

    548
    43
    320
    Nov 1, 2024
    Male
    9:49 PM
    Can confirm that it worked basically plug and play to launch lower resolutions.
    i personally have little bit more personal settings going on and got resolution 2 and ability to fullscreen with it so works better for me
    maple2.jpeg
     
    Last edited: Apr 13, 2026
    • Great Work Great Work x 1
  17. creative
    Offline

    creative Nightshadow

    691
    3,958
    410
    Nov 2, 2019
    Male
    3:49 PM
    I decided to give Debain Stable a try since I have a free 500GB SSD just sitting in my system doing nothing since I haven't had much luck with it on LMDE 7. After downloading and installing everything, it worked like a charm. I may switch to Debian Stable then one of these days since it even got better FPS than Conty did!
     
    • Great Work Great Work x 1
  18. Archina
    Offline

    Archina Mano

    10
    3
    20
    Apr 6, 2025
    Male
    8:49 PM
    Client seems to work alright here though it seems to have the same issue as the previous guide where attempting to fullscreen the game just gives me the same resolution with the rest filled in black. This can be 'fixed' by forcing fullscreen in KDE (though all that does is ignore the rest of the screen so you end up with partially incorrect scaling and your mouse only works on a tiny section.) The error given when using alt+enter is this:
    Code:
    0148:err:d3d:wined3d_swapchain_resize_buffers Something's still holding back buffer 0 (020AFDB0).
    0154:err:d3d:resource_unload Resource 0CF3E288 is being unloaded while mapped.
    0148:err:d3d:wined3d_swapchain_resize_buffers Something's still holding back buffer 0 (07AC54E8).
    
    Also noticed a bug where if you fullscreen via alt+enter, switch to another window and then try to switch back (you seem to need to click another window to trigger this), the game immediately minimises itself and refuses to come back; forcing you to close the game and restart. The terminal gives no logs on this error unfortunately.

    Currently running on EndeavourOS (Arch-based) with Wayland WM and KDE.
     
  19. cl_ogar0
    Offline

    cl_ogar0 Wolfspider

    548
    43
    320
    Nov 1, 2024
    Male
    9:49 PM
    have you tried forcing wayland driver?
    Can be done through winetricks
     
  20. Archina
    Offline

    Archina Mano

    10
    3
    20
    Apr 6, 2025
    Male
    8:49 PM
    That I would be unsure about. I have very little knowledge with wine in general I'm afraid ^^;
     

Share This Page