How To Play on Linux: Difference between revisions

From MuhRO
Jump to navigation Jump to search
Cruro (talk | contribs)
mNo edit summary
Cruro (talk | contribs)
Replaced mention of winetricks and dxvk with pointer towards patcher-addon dxvk-setting, removed link to incorrect patcher, moved proton-usage to bottom with warning and undo-instructions
Line 2: Line 2:


===Requirements===
===Requirements===
You can use [https://www.winehq.org/ Wine] or Proton<br>
[https://www.winehq.org/ Wine]<br>
webkit2gtk4.0<br>
webkit2gtk4.0
Linux Patcher: [https://patcher.muhro.eu/patches/patcher/linux/Muh_Patcher Muh Patcher Linux]<br>
winetricks(optional)


== Pre-Requisite Installations ==
== Pre-Requisite Installations ==
Line 16: Line 14:
If your distribution has a outdated Wine version Download Wine by going to [https://wiki.winehq.org/Download this link] and follow the instructions for your specific Linux distribution to install.
If your distribution has a outdated Wine version Download Wine by going to [https://wiki.winehq.org/Download this link] and follow the instructions for your specific Linux distribution to install.


==== Proton ====
Install Proton 10 on steam<br>
Follow the instructions on [[How To Play on Linux#Using Proton]]


==== Webkit2gtk4.0 ====
==== Webkit2gtk4.0 ====
Some distributions do not include this dependency and must install it manually. The patcher will not launch if this dependancy is not installed.
Some distributions do not include this dependency and must install it manually. The patcher will not launch if this dependency is not installed.<br />
Fedora/RHEL: <code>sudo dnf install webkit2gtk3-devel</code>
Fedora/RHEL: <code>sudo dnf install webkit2gtk3-devel</code><br />
Arch Linux : <code>sudo pacman -S webkit2gtk webkit2gtk-4.1</code>
Arch Linux : <code>sudo pacman -S webkit2gtk webkit2gtk-4.1</code><br />


== Installing MuhRO ==
== Installing MuhRO ==
Line 37: Line 32:
Extract the zip file to the location you would like to store the game on your computer.
Extract the zip file to the location you would like to store the game on your computer.


Navigate to the folder you extracted and double click on Muh_Patcher. '''('''You may have to go to files properties and mark it as executable in the permissions tab before it will launch).
Navigate to the folder you extracted and double click on Muh_Patcher.  
 
'''You may have to go to files properties and mark it as executable in the permissions tab before it will launch.'''


[[File:Muh Patcher.png|598x598px]]
[[File:Muh Patcher.png|598x598px]]
Line 52: Line 49:
Enter your Master Account Login and select your character account to begin playing.
Enter your Master Account Login and select your character account to begin playing.


== Using Proton ==
'''Note: Since client update from 13th August 2026, proton is <strong>not</strong> necessary anymore to run the client (and might get in the way of using the MuhUI feature of this server).<br />Regular wine versions (including up-to-date ones) should work just fine.'''
You can use Proton setting the patcher with an environment variable<br>
Create a file named proton-wrapper.sh inside muhro folder with this content:
<pre>#!/bin/bash
PROTON_DIR="$HOME/.steam/steam/steamapps/common/Proton 10.0"
APPID="muhro"
STEAM_COMPAT_DATA_PATH="$HOME/.steam/steam/steamapps/compatdata/$APPID"
STEAM_COMPAT_CLIENT_INSTALL_PATH="$HOME/.steam/steam"
mkdir -p $HOME/.steam/steam/steamapps/compatdata/$APPID
export PROTON_DIR
export APPID
export STEAM_COMPAT_DATA_PATH
export STEAM_COMPAT_CLIENT_INSTALL_PATH
export SteamAppId="$APPID"
"$PROTON_DIR/proton" run "$@"</pre>
Open a terminal in muhro folder:
Make the file executable with <code>chmod +x proton-wrapper.sh</code>
Execute the patcher with <code>env RPATCHUR_WINE=/path/to/gamefolder/proton-wrapper.sh ./Muh_Patcher</code>
To create a Desktop Shortcut follow instructions: [[How To Play on Linux#Creating an Application Desktop/Menu Entry]]




Line 103: Line 71:


Type=Application
Type=Application
</blockquote><big>'''If using proton replace'''</big> <code>exec=</code> with <code>Exec=env RPATCHUR_WINE=/path/to/gamefolder/proton-wrapper.sh path/to/gamefolder/Muh_Patcher</code>
</blockquote>




Line 114: Line 82:
You may have to log out and back in to see the start menu entry.
You may have to log out and back in to see the start menu entry.


== Winetricks ==
'''Disclaimer: not needed if running with proton.'''


Winetricks is useful if you want [https://github.com/doitsujin/dxvk DXVK] (run the game with vulkan)
== Known Problems ==
 
====Bad performance====
===Install winetricks===
Using dxvk can often give significant performance benefits. To use it, follow these steps:


Fedora/RHEL: <code>sudo dnf install winetricks</code>
* Start the patcher
* On the left side, click on "Addons"
* Find "Renderer" and set it to "dxvk"
* Done! You can now launch the game


Arch Linux: <code>sudo pacman -S winetricks</code>
[[File:Patcher-addons-dxvk.png|frameless]]


Debian/Ubuntu/Pop_OS/Mint: <code>sudo apt install winetricks</code>
====Performance on hybrid graphics====
When running hybrid graphics (e.g. onboard graphics + dedicated nvidia GPU), the following environment variables may help when launching the game:


=== Install DXVK : ===
<code>__NV_PRIME_RENDER_OFFLOAD=1 __GLX_VENDOR_LIBRARY_NAME=nvidia ./Muh_Patcher</code>
Open terminal and
<code>WINEPREFIX=/<path to wineprefix>/ winetricks dxvk</code>


== Known Problems ==
====Unacceptable TLS certificate====
====Unacceptable TLS certificate====
This issue seems to affect Ubuntu 22.04 and all other distro based on it (KDE Neon) <br>
This issue seems to affect Ubuntu 22.04 and all other distro based on it (KDE Neon) <br>
Solution: so far changing distro
Solution: so far changing distro


====Version `GLIBC_X.XX' not found====
 
The distribution used may not come with the dependencies needed for the shipped linux patcher. <br />
== <strong>(!Not recommended anymore!)</strong> <del>Using Proton</del> ==
Solution: Try the alternative patcher linked [https://discord.com/channels/822793286786875403/1129804674594254909/1347879182927134731 here]
 
'''Note: Since client update from 13th August 2026, proton is <strong>not</strong> necessary anymore to run the client (and might get in the way of using the MuhUI feature of this server).<br />Regular wine versions (including up-to-date ones) should work just fine.'''
 
You can use Proton setting the patcher with an environment variable<br>
Create a file named proton-wrapper.sh inside muhro folder with this content:
 
<pre>#!/bin/bash
PROTON_DIR="$HOME/.steam/steam/steamapps/common/Proton 10.0"
APPID="muhro"
STEAM_COMPAT_DATA_PATH="$HOME/.steam/steam/steamapps/compatdata/$APPID"
STEAM_COMPAT_CLIENT_INSTALL_PATH="$HOME/.steam/steam"
mkdir -p $HOME/.steam/steam/steamapps/compatdata/$APPID
 
export PROTON_DIR
export APPID
export STEAM_COMPAT_DATA_PATH
export STEAM_COMPAT_CLIENT_INSTALL_PATH
export SteamAppId="$APPID"
 
"$PROTON_DIR/proton" run "$@"</pre>
 
Open a terminal in muhro folder:
 
Make the file executable with <code>chmod +x proton-wrapper.sh</code>
 
Execute the patcher with <code>env RPATCHUR_WINE=/path/to/gamefolder/proton-wrapper.sh ./Muh_Patcher</code>
 
'''If you have created a menu-entry''' ([[How To Play on Linux#Creating an Application Desktop/Menu Entry]]), the following entry
 
<code>Exec=PATH TO FOLDER CONTAINING GAME FILES/Muh_Patcher</code>
 
should be replaced with
 
<code>Exec=env RPATCHUR_WINE=/path/to/gamefolder/proton-wrapper.sh path/to/gamefolder/Muh_Patcher</code>
 
=== Removing proton-usage ===
 
Remove the <code>RPATCHUR_WINE</code> environment variable from your desktop-file, or don't use it anymore when manually launching the patcher.
 
Optionally, the proton-wrapper.sh may be deleted, but in any case it will not be invoked anymore if the environment variable is removed or renamed.

Revision as of 15:56, 14 August 2026

This page is heavily work in progress! If you have additional Informations, feel free to add it or inform the Team about it.

Requirements

Wine
webkit2gtk4.0

Pre-Requisite Installations

Wine

Fedora/RHEL: sudo dnf install wine
Arch Linux: sudo pacman -S wine
Debian/Ubuntu/Pop_OS/Mint: sudo apt install wine

If your distribution has a outdated Wine version Download Wine by going to this link and follow the instructions for your specific Linux distribution to install.


Webkit2gtk4.0

Some distributions do not include this dependency and must install it manually. The patcher will not launch if this dependency is not installed.
Fedora/RHEL: sudo dnf install webkit2gtk3-devel
Arch Linux : sudo pacman -S webkit2gtk webkit2gtk-4.1

Installing MuhRO

If you haven't already, create a master account and confirm your email address.

Once you have a master account, and verified through discord, you can download MuhRO by entering /download (typed, not pasted) in any discord channel.


Download the Full Client using the mirror of your choice.

Extract the zip file to the location you would like to store the game on your computer.

Navigate to the folder you extracted and double click on Muh_Patcher.

You may have to go to files properties and mark it as executable in the permissions tab before it will launch.


The first time that you launch it you will need to click Game Setup on the left hand menu.

Configure your settings in the Game Setup menu. Click Apply, then click OK.

Enter your Master Account Login and select your character account to begin playing.


Creating an Application Desktop/Menu Entry

Create a new text file named MuhRo.desktop in /home/USERNAME/.local/share/applications (replace USERNAME with your local username).

Enter the following into the text file and save it. Make sure to replace PATH TO FOLDER CONTAINING GAME FILES with the path to the folder containing your game files.

[Desktop Entry]

Comment=MuhRo

Exec=PATH TO FOLDER CONTAINING GAME FILES/Muh_Patcher

Icon=PATH TO FOLDER CONTAINING GAME FILES/muhro.ico

Name=MuhRo

Path=PATH TO FOLDER CONTAINING GAME FILES

StartupNotify=true

Terminal=false

Type=Application


Make the file executable by either opening the files properties and marking it as executable in the permissions tab or run the following in terminal.

chmod +x PATH_TO_MUHRO.DESKTOP

Replace PATH_TO_MUHRO.DESKTOP with your path to the MuhRo.desktop file.

You may have to log out and back in to see the start menu entry.


Known Problems

Bad performance

Using dxvk can often give significant performance benefits. To use it, follow these steps:

  • Start the patcher
  • On the left side, click on "Addons"
  • Find "Renderer" and set it to "dxvk"
  • Done! You can now launch the game

Performance on hybrid graphics

When running hybrid graphics (e.g. onboard graphics + dedicated nvidia GPU), the following environment variables may help when launching the game:

__NV_PRIME_RENDER_OFFLOAD=1 __GLX_VENDOR_LIBRARY_NAME=nvidia ./Muh_Patcher

Unacceptable TLS certificate

This issue seems to affect Ubuntu 22.04 and all other distro based on it (KDE Neon)
Solution: so far changing distro


(!Not recommended anymore!) Using Proton

Note: Since client update from 13th August 2026, proton is not necessary anymore to run the client (and might get in the way of using the MuhUI feature of this server).
Regular wine versions (including up-to-date ones) should work just fine.

You can use Proton setting the patcher with an environment variable
Create a file named proton-wrapper.sh inside muhro folder with this content:

#!/bin/bash
PROTON_DIR="$HOME/.steam/steam/steamapps/common/Proton 10.0"
APPID="muhro"
STEAM_COMPAT_DATA_PATH="$HOME/.steam/steam/steamapps/compatdata/$APPID"
STEAM_COMPAT_CLIENT_INSTALL_PATH="$HOME/.steam/steam"
mkdir -p $HOME/.steam/steam/steamapps/compatdata/$APPID

export PROTON_DIR
export APPID
export STEAM_COMPAT_DATA_PATH
export STEAM_COMPAT_CLIENT_INSTALL_PATH
export SteamAppId="$APPID"

"$PROTON_DIR/proton" run "$@"

Open a terminal in muhro folder:

Make the file executable with chmod +x proton-wrapper.sh

Execute the patcher with env RPATCHUR_WINE=/path/to/gamefolder/proton-wrapper.sh ./Muh_Patcher

If you have created a menu-entry (How To Play on Linux#Creating an Application Desktop/Menu Entry), the following entry

Exec=PATH TO FOLDER CONTAINING GAME FILES/Muh_Patcher

should be replaced with

Exec=env RPATCHUR_WINE=/path/to/gamefolder/proton-wrapper.sh path/to/gamefolder/Muh_Patcher

Removing proton-usage

Remove the RPATCHUR_WINE environment variable from your desktop-file, or don't use it anymore when manually launching the patcher.

Optionally, the proton-wrapper.sh may be deleted, but in any case it will not be invoked anymore if the environment variable is removed or renamed.