MapleRoyals on Steam Deck or other Linux distros - the easy way

Discussion in 'General Discussion' started by Nevon, Jun 30, 2024.

  1. Nevon
    Offline

    Nevon Member

    Joined:
    Jun 28, 2024
    Messages:
    4
    Likes Received:
    7
    Gender:
    Male
    Country Flag:
    IGN:
    Nevon
    There are a couple of other guides about setting up MapleRoyals on Steam Deck. This one in particular is fairly recent, and also goes into suggested key mappings. However, all the guides I've seen so far have been over complicating things for what seems like no reason at all. In this guide, I will show you how braindead easy it is to set up MapleRoyals. The screenshots will be from my Arch Linux desktop, but you can follow the exact same set-up also for Steam Deck.

    1. Install Lutris
    On Steam Deck, you do this by going into desktop mode and searching for "Lutris" in the Discover store. I won't go into details here, because you can just google "installing Lutris on Steam Deck" and you'll find a million guides. Don't worry about ProtonUp, adding Flathub as a flatpak remote, or anything like that. You literally just type in "Lutris" in the Discover search box and click install. You can also find the instructions on the Lutris website.

    If you're on a regular PC with some Linux distribution, you already know how to do this for your particular distribution. One caveat is that you'll also need to install wine if you're not using the Flatpak version of Lutris. Depending on your distro, the way to do this will differ. In my case on Arch, it's just yay -S wine. This is not necessary on Steam Deck.

    2. Install MapleRoyals
    Installing MapleRoyals is no different from installing any other piece of Windows software in Lutris. You do not need to mess with any settings to get it running. No disabling DXVK, running in a virtual desktop etc. Just use the default settings.

    Open up Lutris and press the + button in the top-left corner:
    Screenshot from 2024-06-30 13-27-59.png
    Select "Install a Windows game from an executable":
    Screenshot from 2024-06-30 13-43-27.png

    Provide the game name ("MapleRoyals") and set the identifier to "MapleStory". This is optional, but it means that Lutris will look up game art and such. It has no impact on the actual game functionality.
    Screenshot from 2024-06-30 13-44-18.png
    Now press the "Install" button and select the MapleRoyals installer that you can download from the website.
    Screenshot from 2024-06-30 13-45-52.png
    After a minute or so, you'll go through the installer as usual. As far as I recall, I didn't change any option during installation, choosing to install it to the default "C:\MapleRoyals" directory. "C:\" here represents the root of the Wine prefix, so that the installation is kept separate from any other Windows games you may have installed.

    Once the installation is done, untick the "Launch MapleRoyals" box and close the Lutris installation window. At this point you should have MapleRoyals in your list of games in Lutris, just like I have in my first screenshot. If you click it and press the "Play" button, it should start right up.

    That's it - you are done!


    There are some additional optional steps that you may want to do though.

    Create a Steam shortcut
    Lutris has this functionality built in. Just right click on the game banner and select "Create Steam shortcut". Now the game will be available in the "non-Steam games" tab in Steam. To modify the Steam artwork, I recommend using the Decky steamgriddb plugin.

    Configuring controls for Steam Deck
    After launching the game from the Steam gaming UI, press the Steam button and choose to configure controls. Go to the community mappings tab and press X to show all templates. Pick whichever one you prefer. Modify it to suit your needs.

    My personal preference is to create action overlays that are active when holding down one of the back buttons, which overwrite the behavior of the face buttons. So for example if X is my primary spell, then L4 + X would be set to a buffing spell. That way all the things I use most commonly are available without modifiers, and actions I only need to take every now and then can use the same face buttons but with a modifier held down.

    I also set the left touch pad to activate an overlay menu with entries for all the typical menus, like items, equipment etc.

    The right touch pad is set to behave as a mouse. Whenever I'm touching the right touch pad, another action overlay activates that I call "menuing" which overwrites the left touchpad to act as a scroll wheel, to let me navigate dialog windows.

    It takes a bit of finessing to get a setup that's comfortable, but just start from one of the community templates and make whatever changes make sense to you. Because Maple has a million shortcuts, it's hard to come up with a mapping that's perfect for everybody, but now that I have a good layout, I actually prefer playing with a controller also on my desktop.

    Upscaling the client
    This is not necessary on Steam deck. But if you are running the game on a regular PC with Linux, it would be nice to not have a teeny-tiny window or have to stare at 1024x768 in fullscreen. To do this, we can use the same technology that's used by the Steam client, gamescope. Lutris already has this built-in, so all you have to do is right click the game and choose "Configure". In the configuration dialog, select the "System options" tab, toggle the "Advanced" button to enable the advanced options, and then tick the "Enable Gamescope" toggle and fill in the options like so:
    Screenshot from 2024-06-30 14-01-39.png

    The important thing here is to set the "Game Resolution" to... well... the resolution of the game. By default that's 800x600, but if you go into MapleRoyals system settings, you can change it to 1024x768. The output resolution should be whatever resolution you want to render the game at. I tend to play the game in borderless windowed mode, not taking up the full screen, which is why I have this weird 1824x1368 resolution set. I good default setting would be to set it to whatever your desktop resolution is, if you are intending on playing it fullscreen.

    The "Window Mode" you can set to whatever you want. Like I said, I prefer to play borderless windowed, but set it to whatever you prefer.

    The framerate limiter I honestly don't think you need to set. I read somewhere about issues where MapleStory would run at some insane FPS, causing fans to go crazy, so I limited it to the refresh rate of my monitor. But like I said, if you don't have any issues, you can leave this empty.

    The custom settings I have added determine the upscaler type and filter to use. For a lot of games, you can just leave this empty. By default gamescope will keep the original aspect ratio. But since MapleStory is a pixel art game in 4:3, these are my preferred settings. You can read more about the pixel filter here, but basically it's to prevent non-square pixels when rendering upscaled pixel art.

    The result of these settings is that the game will render in a gloriously upscaled window (or fullscreen, depending on your settings).
     

    Attached Files:

    Last edited: Jul 1, 2024
    Tim, noobgamer97, MerIot and 3 others like this.
  2. Yaro
    Offline

    Yaro Donator

    Joined:
    Jan 6, 2017
    Messages:
    115
    Likes Received:
    131
    Gender:
    Male
    IGN:
    Yaros
    Excellent guide, I will try this on my upcoming Linux install (Windows 10 driving me insane...).

    Here is the reason I ditched it on Linux previously though - running it with wine causes stun/freeze skills to not work properly for some reason.
    They usually starts out OK but stop working completely after 10-15 minute... Monsters just ignore the CC.

    Do you suffer the same issues on your setup?
     
  3. Nevon
    Offline

    Nevon Member

    Joined:
    Jun 28, 2024
    Messages:
    4
    Likes Received:
    7
    Gender:
    Male
    Country Flag:
    IGN:
    Nevon
    Nope, I have noticed no such issues. The only issue I have is that the game thinks I'm playing with a US keyboard layout, when I don't. But I don't know if this is just a game bug that I would experience in Windows as well, or if Wine is causing the keyboard layout information to get lost somehow.
     
  4. takkarakka
    Offline

    takkarakka Member

    Joined:
    Apr 25, 2024
    Messages:
    3
    Likes Received:
    0
    Hi, I followed this guide and got to the point where I've installed MapleRoyals in Lutris.

    Oddly if I don't untick the "Launch MapleRoyals" checkbox, MapleRoyals launches fine. However when I get to the Lutris library page and then try to launch MapleRoyals there, it never launches - when I click Play, the button changes to Stop but MapleRoyals never launches.

    Anyone having this issue?
     
  5. Renn
    Offline

    Renn Member

    Joined:
    Jul 26, 2022
    Messages:
    6
    Likes Received:
    1
    Country Flag:
    Easier way, add the installer as a non-steam game, launch it with Proton Experimental or any version you have tested working, install the game, in Steam change the executable path of the non-steam game to /home/deck/.steam/steam/steamapps/compatdata/<appid of your non-steam game>/pfx/drive_c/<path you chose in the installer>/MapleRoyals.exe and start the it again.

    If you are not sure about the path, this command would help:
    find /home/deck/.steam/steam/steamapps/compatdata -name MapleRoyals.exe

    For updates just change the executable path to the new installer and repeat these steps.
     
    Last edited: Oct 5, 2024
  6. J-Fr
    Offline

    J-Fr Member

    Joined:
    Jul 19, 2020
    Messages:
    3
    Likes Received:
    1
    Gender:
    Male
    Country Flag:
    Hey, I had the same issue here. You want to go to Configure > Game options tab > Executable is set to the first .exe file. Change it to MapleRoyals.exe.
     

Share This Page