Official How to Run YunaMS on Linux with Bottles

[FlySlime]

Running YunaMS on Linux with Bottles​

Please refer to this guide if you're a Steam Deck user, as this guide is only for Desktop Linux users. See you in-game!

Prerequisites​

• Install Bottles via Flatpak.
  

  flatpak install flathub com.usebottles.bottles

• Install winetricks on your system.
• Download the YunaMS Patcher for Linux files and put them in your YunaMS folder (replace if asked).
• Ensure that your YunaMS folder exists somewhere within the /home directory.

Setting up Bottles​

Since we're using the Flatpak version of Bottles, we need to run the following command to prevent sandboxing:

flatpak override --user --filesystem=home com.usebottles.bottles

1. Create a Gaming Bottle named YunaMS.
2. Run the following command to install dinput8:

   WINEPREFIX=~/.var/app/com.usebottles.bottles/data/bottles/bottles/YunaMS winetricks dinput8

3. In Bottles, click Dependencies and install dotnetcoredesktop6.
4. Add YunaMS.exe as a shortcut in Bottles.
5. Add Patcher.exe as a shortcut in Bottles and launch it.

If you encounter a "Monitor Resolution" error, enable Virtual Desktop or gamescope and match it to your monitor's resolution. This issue often arises with multi-monitors on X11 or tiling window managers.

After the Patcher is finished, the game will open, and you can start playing. When you're not patching, you can launch the game directly by running YunaMS.exe. Don't forget to configure settings.ini in the YunaMS folder. Enjoy!

(Optional) Key repeat on ALT, CTRL, and SHIFT​

Due to issues with Linux and Wine, the keys ALT, CTRL, and SHIFT do not repeat when held down, which means we have to continuously press them to repeat their actions. This issue can be fixed using the program input-remapper.

If you're a Steam Deck user, go to your controller configs and enable turbo repeat for these keys instead.

1. Install input-remapper by following the instructions on the GitHub page.
2. Run the program and select the correct input device.
3. Select new preset.
4. Rename the preset to YunaMS.
5. Press Add and then record the following keys: Alt L, Control L, and Shift L.
6. For each key, select Key or Macro and insert the following macros:
   

   # Alt L (US keyboard layout, 2 ALT keys)
   key_down(Alt_L).hold(key(Alt_R).w(50)).key_up(Alt_L)
   # ALT L (non-US keyboard layout, 1 ALT key)
   hold(repeat(1, key_down(Alt_L).wait(50).key_up(Alt_L)))
   # Control L
   key_down(Control_L).hold(key(Control_R).w(100)).key_up(Control_L)
   # Shift L
   key_down(Shift_L).hold(key(Shift_R).w(100)).key_up(Shift_L)

7. Press Apply, and make sure not to press any keys for a few seconds while it applies.
8. Once you're done playing, simply press Stop to disable the preset.

Now you can play YunaMS with proper key repeat functionality!

Note: There is currently an issue with the non-US macro when trying to use combinations like ALT+TAB. If you have any suggestions for improving the macros, feel free to reach out to us!

Troubleshooting​

If you encounter any issues while following this guide, feel free to join the active Discord server. We're here to help troubleshoot and get things running smoothly. Be sure to check out #linux-troubleshooting for appropriate support.

 

[yuna]

Approved!!

 

[BuccPlus1]

Note that Input Remapper changed their naming convention, and that section should be updated to the following:

# Alt L (US keyboard layout, 2 ALT keys) (LEFTALT)
key_down(KEY_LEFTALT).hold(key(KEY_RIGHTALT).w(50)).key_up(KEY_LEFTALT)
# ALT L (non-US keyboard layout, 1 ALT key) (LEFTALT)
hold(repeat(1, key_down(KEY_LEFTALT).wait(50).key_up(KEY_LEFTALT)))
# Control L (LEFTCTRL)
key_down(KEY_LEFTCTRL).hold(key(KEY_RIGHTCTRL).w(100)).key_up(KEY_LEFTCTRL)
# Shift L (LEFTSHIFT)
key_down(KEY_LEFTSHIFT).hold(key(KEY_RIGHTSHIFT).w(100)).key_up(KEY_LEFTSHIFT)