Installing ML on Linux Guide (updated)

This is an updated guide that will hold your hand through the process of installing MapleLegends on a Linux OS with Wine.

Spoiler: What is Wine and how can it help me run MapleLegends?

Wine makes it possible to run Windows programs alongside any Unix-like operating system, particularly Linux. At its heart, Wine is an implementation of the Windows Application Programing Interface (API) library, acting as a bridge between the Windows program and Linux. Think of Wine as a compatibility layer, when a Windows program tries to perform a function that Linux doesn't normally understand, Wine will translate that program's instruction into one supported by the system.

Step 1: Installing a 32-bit version of wine:​

Type the following commands line by line into your terminal:

Code:

$ sudo apt update -y && sudo apt upgrade -y
$ sudo apt install wine

Code:

$ sudo rm -rf ~/.wine

WARNING: The above command removes everything you have installed under Wine. Make sure you move your stuff aside first! If this is your first time using wine you have nothing to worry about.

Code:

$ export WINEARCH=win32
$ winecfg

Set "Windows Version" to Windows 98 and press OK.

Step 2: Installing and setting up Winetricks: no longer needed as of 11/02/22

Spoiler: .

Code:

$ sudo apt install winetricks
$ winetricks

Select the default wineprefix > Install a Windows DLL or component...
Select the following:
(d3dx9_26, d3dx9_28, d3dx9_31, d3dx9_35, d3dx9_39, d3dx9_42, d3dx9_43, vcrun6sp6)

Then hit OK.
If you get a sha256sum mismatch! error, refer to error 1 at the end of this guide.

Step 2: Downloading MapleLegends files & DLL:
First you need to download the latest version of ML's mac files, you can do that by Clicking here.
(Make sure you download the wineskins version, not the crossover version!)

After you're done installing the game files, open it, open the MapleLegends2020.pkg folder and extract payload to a place of your choice.
(I suggest creating a folder called MapleLegends in the home directory for easy access)
After you're done extracting payload, make sure to rename it to payload.xar or it won't unpack properly.


After you're done you can right click on it and select "extract here".
Once payload is fully extracted, open the folder and go to Payload > Applications > MapleLegends.app > drive_c. Copy the MapleLegends folder from there and paste it into the main MapleLegends folder where you first extracted payload for easy access.

Now you need to download two extra DLLs for ML to work properly:
http://www.mediafire.com/?bvt20olayvfbgw7 FOR ws2_32.dll
http://www.mediafire.com/?7c9tee7fhvebopc FOR ws2help.dll

After you have finished downloading them, make sure you paste them into the following location:
home (ctrl + h to view hidden files) > .wine > drive_c > windows > system32
paste those two files (ws2_32.dll & ws2help.dll) inside system32.
MAKE SURE YOU CLICK REPLACE AND NOT SKIP WHEN THE FILE CONFLICT MESSAGE APPEARS!

Step 3: Launching MapleLegends:
(if you want to launch it with Lutris instead, skip to the end of the guide)

Code:

$ cd /home/<username>/MapleLegends/MapleLegends && wine ./MapleLegends.exe

(or whichever location you saved the game files in)
(Remember to press alt + enter if you have wine set to emulate a viirtual desktop to get rid of the blue background)


Optional:
- Setting up a bash script: (recommended)
Open gedit or your preferred text editor and type in the following:

Then save it as MapleLegends.sh and type the following command into your terminal:

Code:

$ chmod +x MapleLegends.sh

Now you can launch the game simply by typing:

Code:

$ ./MapleLegends.sh

You can also set it to open with a keyboard shortcut by assigning a key to that terminal command.



- Running Multiple Clients (optional)
Type the following into your terminal

Code:

$ winecfg

Click Graphics, then untick "Emulate a virtual desktop" (note that you won't be able to run the clients in 1366x768 resolution)
After you disabled that option you'll be able to run multiple clients without having to create multiple wine prefixes.

- Running ML with Lutris (optional)
First we have to download Lutris:

Code:

$ sudo apt install lutris
$ lutris

Click the '+' sign at the top left corner to add a new game.
Under Game info:
- Name it MapleLegends.
- Set Wine as the Runner.
Under Game options:
- Next to the Executable, click browse and select the executable from the MapleLegends folder that we extracted from Payload.
Make sure you select MapleLegends.exe NOT ._MapleLegends.exe
- Next to Working Directory, click browse and point it to the same folder.
- Set the Prefix architecture to 32-bit.
It should look something like this:

Under Runner options:
- Disable Enable DXVK/VKD3D.
- Enable Windowed (virtual desktop).
Under System options:
- Next to Default installation folder, set it to the same location as the working directory.
- Enable Disable Lutris Runtime.
Press save.
Open Lutris, select MapleLegends and press Play.

- Allowing your cursor to leave the client (lutris) (optional)
Wine Configuration > Graphics > Untick "Automatically capture the mouse in full-screen windows"

- Running Multiple 1366x768 Clients (lutris) (optional)
Make a copy of your '.wine' folder in the home directory and name it: '.wine2'.
In lutris configurations under Game options set the Wine prefix to the copied .wine directory (.wine2).
You will now be able to run another emulated virtual desktop to sustain 1366x768 Clients. You can run one instance of the game from the terminal, and another from lutris with a different wine prefix set, or both of them from lutris but you have to make a new game copy inside lutris and specify different wine prefixes.
(note that you have to have 'Emulate a virtual Desktop' enabled in the wine configs, refer to error number 1)

Errors:

Spoiler: .

1- If you get a sha256sum mismatch error upon trying to install vcrun6sp6, do the following:

Code:

$ sudo apt-get remove winetricks
$ wget  https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks
$ chmod +x winetricks
$ sudo mv -v winetricks /usr/local/bin

Then repeat Step 2 without reinstalling winetricks.

1- If you have a dual monitor setup and don't want your client to misbehave if you accidentally alt + enter, or if 1366x768 resolution doesn't work, type:

Code:

$ winecfg

Click Graphics, then tick "Emulate a virtual desktop"

2- If clicking the Play button on lutris doesn't work, type the following line in your terminal and try again:

Code:

$ pkill wine

A special thanks to Cak33, this guide would not have been possible without his help.