Official How to Run YunaMS on a Steam Deck / Linux

[iSpicyCurry]

Last Updated: 10/6/24​

Hello! This guide will walk you through the steps for installing YunaMS using Lutris! The following steps are applicable to both the Steam Deck and Linux on a whole.
Note (10/6/24): There is a bug pushed to Lutris winetricks where winetricks is not executable. Follow the instructions under the debugging section after you've installed Lutris before installing YunaMS.

Prerequisites​

• Install Lutris for your distribution: https://lutris.net/downloads
  Note: For Steam Deck follow the SteamOS instructions
• Install winetricks using your distro's package manager
  Note: Only necessary if not using the Flatpak / SteamOS version of Lutris
• Download YunaMS game files (no need to extract)

Install YunaMS​

Note: If installing on the Steam Deck, first hold the power button and select Switch to Desktop.

1. Open Lutris. It will automatically install some dependencies for gaming.
2. On the left under runners, click on the box icon of the wine runner to manage wine versions.
   
3. Click install on wine-ge-8-26. This will install the wine runner we need to run YunaMS.
4. Once completed, press Ok.
5. On the upper left corner, press the + button.
6. Select Search the Lutris website for installers.
   Note: alternatively you can navigate to https://lutris.net/games/yunams/ and click install from there. Skip to step 8.
   
7. Type in 'yunams' and click on YunaMS.
   
8. Click Install.
9. Click Continue on the top right.
10. Select the YunaMS.rar file you downloaded above.
    
11. Click Install on the top right.
12. The installer will install all necessary dependencies. You should see the Patcher pop up for a second at the end.
13. Once the installer completes the setup, click Close on the top left.
14. At this point you should have YunaMS installed! Before playing, let's set up the Patcher.
    
15. Right click the YunaMS game above and select Duplicate from the drop down menu.
16. Rename the duplicate to YunaMS Patcher.
17. Right click YunaMS Patcher and select configure.
18. Click the Game options tab and change the executable to Patcher.exe.
    
19. Click Save.
20. Select the YunaMS Patcher and press Play to confirm it launches. The Patcher should show a progress bar and then exit.
    Note: Running the patcher will reset your settings.ini file!
21. Now you're all set to play YunaMS! Select YunaMS and hit Play!
    Note: For Steam Deck users, the game will show a black screen and play music before crashing when launched in Desktop Mode!
    1. For Steam Deck users you must either add Lutris oradd YunaMS to Steam to play in Gaming Mode:
       1. Steps to Add Lutris to your Steam library
       2. Right click YunaMS and select Create Steam Shortcut. Give it a few seconds to add the shortcut and then return to gaming mode.
          Note: method 2 might be preferable for controller configuration! The controller config will save to YunaMS in your steam library rather than to Lutris.

Steam Deck Tips​

Here are some controller configs I set up on my deck that make the experience awesome:

1. Configure the left track pad to be a virtual menu for all inventory, map, skill, etc buttons. Set it to activate on release.
2. Configure the right analog stick to be a virtual menu for F1-12. Configure the center tap to be Z for picking up items.
3. For alt, ctrl and shift buttons, go into the button settings and enable turbo repeat. This will allow you to hold down the button!

Debugging Issues​

This section contains a compilation of issues that have popped up and how to fix them

Lutris Winetricks permissions​

If you receive the following error when installing:

Traceback (most recent call last):
  File "/app/share/lutris/bin/lutris-wrapper", line 205, in <module>
    main()
  File "/app/share/lutris/bin/lutris-wrapper", line 132, in main
    processpid = subprocess.Popen(args).pid
                  ^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib/python3.11/subprocess.py", line 1026, in _init
    self._execute_child(args, executable, preexec_fn, close_fds,
  File "/usr/lib/python3.11/subprocess.py", line 1955, in _execute_child
    raise child_exception_type(errno_num, err_msg, err_filename)
PermissionError: [Errno 13] Permission denied: '/home/deck/.var/app/net.lutris.Lutris/data/lutris/runtime/winetricks/winetricks'

This is an issue with the bundled winetricks in Lutris. To fix it:

1. Navigate to `/home/deck/.var/app/net.lutris.Lutris/data/lutris/runtime/winetricks/`
2. Right click winetricks
3. Go to Properties > Permissions
4. Check the 'Is executable' box and hit OK
5. Re-run the Installer
   

Credits​

Huge shout out to Yuna, FlySlime and DarkSirrush on the Discord community for getting YunaMS working on Linux! This would not have been possible without all of your help! Thank you!

 

[yuna]

Approved and verified!!

 

[Kcroucher17]

Thanks for the post, I'm glad others are playing on Deck as well.

Though I'm having an issue with getting the game to launch in Gaming Mode. It does the same thing as Desktop mode where the music plays for a few seconds before crashing. I've tried performing the install steps from scratch again but the issue is persisting.

Any ideas on what I can try?