The EASIEST way to run MapleLegends on Linux - Unofficial Linux Client

Linux has always been a pain in the ass to setup and play, with differing instructions between running vanilla wine, lutris, and the steam deck guides, and for those who are inexperienced, somehow all these may somehow magically not work out. For those who still have problems with it, or are too lazy to set it up, my client (which is honestly just a script for setting up wine, winecfg and dll replacements) should help to run the game with minimal effort and knowledge.

Tested on LMDE 6, but since this client runs on wine AppImage, I believe it will run on every linux desktop (that isnt arm based)

Edit: Tested on steam deck, working without any issue

Spoiler: picture of it running on steam deck

borrowed from a friend to test

Download MapleLegends_LINUX_UNOFFICIAL_10FEB2025:
https://u.pcloud.link/publink/show?code=XZMJiH5ZCL74ehL3HbpFXfvlM8h2ySxWmni7

Optional: If you just wanna view my kiddy scripts and manually setup the client, can view my github repo here:
https://github.com/xiujk71/maplelegends-client-scripts

Some stuffs to take note:
- Your system needs to be able to run AppImage executable, as my script uses Wine AppImage.
- You are NOT required to install Wine on your system. A copy of Wine AppImage is provided instead.
- My script will create a wine prefix at "/home/<username>/maplelegends_prefix". Ensure that there is no "maplelegends_prefix" in your home folder when running my script for the first time.
- You can manually update the MapleLegends client by replacing ./MapleLegends folder with the one from new MAC client
- Does NOT work with systems that has AppImageLauncher installed. Make sure to uninstall it

Instructions to run the client:
1. Extract the 7z content on your PC
2. Ensure maplelegends.sh, maplelegends-windowed.sh, ml_winecfg.sh & wine.AppImage have executable permissions enabled.

Spoiler: how to set executable permissions on linux mint

Right click on the file -> Properties -> Permissions -> Tick "Allow executing files as program"

pic uploader

to use command line instead, use
chmod +x "filename"
can view examples here: https://bash.cyberciti.biz/guide/Setting_up_permissions_on_a_script

3. Run maplelegends.sh on the terminal. Wait for the first client to launch. Then run again to spawn more clients if you wish to.

Spoiler: I can't get it to run!

1. If you are getting this error as shown below, run ./maplelegends-windowed.sh and see if it works.


2. If you receive AppImageLauncher error, make sure to uninstall that

Spoiler: motivation for creating unofficial client

There has been some talks on attempting to make a working client on flatpak, but nothing was done. I've then discovered Wine AppImage and had been holding persosnal scripts for about a year that runs MapleLegends via the AppImage, but was too lazy to polish it.

if the scripts proves to be user-friendly enough to simply click-and-run without any knowledge, we may have a reason to maintain a linux client officially, which will help to simplify the small percentage of linux & steam deck users here

Acknowledgements:

• https://www.winehq.org
• https://github.com/mmtrt/WINE_AppImage
• https://github.com/doitsujin/dxvk/

 

The error is quite normal. After about 3-5 seconds of it, MapleLegends should appear.


But if MapleLegends doesn't appear and simply just crash, there may be a chance that Windows 98 is not being set by my script.

In that case, run ml_winecfg script to launch the winecfg for the maplelegends_prefix, and ensure Windows 98 is selected.

if it still doesn't work, delete the maplelegends_prefix folder in /home/<username>/ and run the maplelegends.sh again

 

let me know if the above post helps.
I've only tested it on my system, and i don't have a steam deck to test. if there's a need to, i'll refine my scripts.

if it still doesn't work, can you send me whats the end of the Konsole? The messages at the end will help me with solving the issues. Thanks

Edit: if anyone fails to get it to work too, please let me know. I want to refine it until its universally working

 

just to double check, have you confirmed that Windows 98 is selected in the wine configuration? You can check it by running the ml_winecfg script.

 

tested on steam deck, script works without any form of modification.
borrowed it from a friend to test.

Any steam deck users around? Would like some help in getting it onto the steamOS's launcher, and make it a seamless experience for all

 

looks like what u have there is an appimage error. im not familiar with it myself. but can you double check if your VM can run wine? not from appimage, but the one thats locally installed.

 

i did some googling and found this:
https://github.com/TheAssassin/AppImageLauncher/issues/602

there's a possibility that appimage launcher is causing an issue. do you mind uninstalling it and try again? thanks

if this works, i might need to create a script that does extract-and-run instead

 

The quick solution will be to double click on ./maplelegends.sh and see if your desktop environment allows it to be run directly, without the terminal on.

Other solution would be to write a .desktop file. I'll have to explore this, for i have not written one before. If you can write one, you can test it first hahah

 

Hey, are you still up for testing? I have an idea to make it work with systems having AppImage Launcher installed.

Rename "Wine.AppImage" to "wine-appimage.bin"
then, open up ./maplelegends.sh and replace the codes inside with the one in the spoiler below:

Spoiler: maplelegends.sh code test

Code:

#!/bin/bash
dir_script=$(dirname $(realpath $0))
dir_ml=$dir_script/MapleLegends
dir_dll_files=$dir_script/dll_files
dir_prefix_system32=$HOME/maplelegends_prefix/drive_c/windows/system32

echo $dir_prefix_system32
if [[ -d "$dir_prefix_system32" ]]; then
    echo "maplelegends_prefix found"
   
else

    echo "maplelegends_prefix not found"

    echo "Creating maplelegends_prefix in $HOME/maplelegends_prefix"
    cd $dir_ml
    echo $(pwd)
    WINEPREFIX="$HOME/maplelegends_prefix" WINEARCH=win32 $dir_script/wine-appimage.bin wineboot
    echo "Success"

    echo "Updating ws2_32.dll and ws2help.dll "
    cd $dir_script
    cp "$dir_dll_files/ws2_32.dll" "$dir_prefix_system32/ws2_32.dll"
    cp "$dir_dll_files/ws2help.dll" "$dir_prefix_system32/ws2help.dll"
    echo "Success"

    # echo "Copying dxvk-1.10.3 dlls"
    # cp "$dir_dll_files/dxvk-1.10.3/x32/d3d9.dll" "$dir_prefix_system32/d3d9.dll"
    # cp "$dir_dll_files/dxvk-1.10.3/x32/d3d10.dll" "$dir_prefix_system32/d3d10.dll"
    # cp "$dir_dll_files/dxvk-1.10.3/x32/d3d10_1.dll" "$dir_prefix_system32/d3d10_1.dll"
    # cp "$dir_dll_files/dxvk-1.10.3/x32/d3d10core.dll" "$dir_prefix_system32/d3d10core.dll"
    # cp "$dir_dll_files/dxvk-1.10.3/x32/d3d11.dll" "$dir_prefix_system32/d3d9.dll"
    # cp "$dir_dll_files/dxvk-1.10.3/x32/dxgi.dll" "$dir_prefix_system32/d3d11.dll"
    # echo "Success"

    # applying overwrite breaks the runtime, unsure why
    # echo "Overwrite DLLs for dxvk-1.10.3"
    # WINEPREFIX="$HOME/maplelegends_prefix" WINEARCH=win32 $dir_script/wine.AppImage regedit $dir_dll_files/dxvk-1.10.3.reg
    # echo "Success"

    echo "Setting to Windows 98"
    WINEPREFIX="$HOME/maplelegends_prefix" WINEARCH=win32 $dir_script/wine-appimage.bin regedit $dir_dll_files/win98.reg
    echo "Success"

fi

echo "Starting MapleLegends"
cd "$dir_ml"
WINEPREFIX="$HOME/maplelegends_prefix" WINEARCH=win32 $dir_script/wine-appimage.bin ./MapleLegends.exe

 

Hey bro, i've figured out your error:
You went to edit Legends.ini inside the MapleLegends folder, and set HDClient = 2.


Using 1368 x 768 is unfortunately broken, and out of my knowledge. With my scripts it is not working. Please change back to HDClient = 0 or 1.

 

hmm, the permissions looks correct. tho it looks like the terminal command may be incorrect. there's two things to try. and if its still not working, can you attach a screenshot of your terminal? thanks!

first possible solution:
- try double clicking on maplelegends.sh, and see if you can run it.

second possible solution
1. inside the folder where maplelegends.sh is at, right click on an empty spot of the file explorer/manager, and click on "Open in terminal" or similar
2. type "./maplelegends.sh" and see if maplelegends runs. the ./ characters are very important, make sure to include it.