Troubleshooting: Difference between revisions

<languages/>

<translate>

Most problems can be resolved without reinstalling Windows or disabling security software. Follow the steps below in order and stop when the problem is fixed.

# Close <code>Muh.exe</code>, <code>Muh_Patcher.exe</code> and <code>updater.exe</code>. Use Task Manager if one remains open.

# Restart the computer if Windows, a graphics driver or a runtime was recently updated.

# If an error appears, keep the exact text or take a screenshot before closing it.

Install or extract MuhRO into a short, local folder such as:

Avoid installing the game in:

* <code>C:\Program Files</code> or <code>C:\Program Files (x86)</code>;

* the Windows or System32 directories;

* a folder with non-English letters, special symbols or an unusually long path.

A path using only normal Latin letters and numbers is recommended. Do not run the patcher from inside a ZIP archive; extract the complete client first.

Try these steps:

# Start the patcher and make sure all updates complete.

# Run '''Game Setup''', choose a normal resolution and save the settings.

# Check Windows Security or your antivirus Protection History for files removed from the MuhRO folder.

The x86 Visual C++ runtime is required by the 32-bit game client, including on 64-bit Windows. Do not download individual DLL files from DLL download websites.

[[File:blank.png]]

This commonly happens when <code>Muh.exe</code> is started directly. Always start <code>Muh_Patcher.exe</code>, sign in and launch the selected game account through the patcher.

Desktop shortcuts must point to <code>Muh_Patcher.exe</code>, not <code>Muh.exe</code>.

Open '''Game Setup''' in the patcher and try the following:

# Select '''DirectX 9''' and save the settings.

# If DirectX 9 does not work, test '''DirectX 7'''.

# Update the graphics driver and restart Windows.

If the message mentions a missing <code>D3DX9</code>, <code>XInput</code> or similar legacy DirectX file, install the official [https://www.microsoft.com/en-us/download/details.aspx?id=35 Microsoft DirectX End-User Runtime].

Remote Desktop sessions and virtual machines may not provide the required graphics acceleration. Test the game directly on the computer.

# Close the game and press Retry or restart the patcher.

# Let the patcher finish verifying and repairing the installation.

# If repair repeatedly fails, perform a clean reinstall into a new empty folder.

Do not randomly delete GRF files or copy GRFs from another server. The patcher can only safely repair files that belong to the current MuhRO release.

# Save Game Setup again.

# Switch between DirectX 9 and DirectX 7.

# Update the graphics driver.

Change one setting at a time so you can identify which change fixed the problem.

[[File:reject.png]]

# Close every running MuhRO client.

# Start the patcher again and sign in with your '''Master Account e-mail address'''.

# If necessary, sign out of the patcher and sign in again to obtain a new launch session.

If the error continues, contact support with the game-account name and exact time of the attempt. Never send staff your password or security code.

Before contacting support:

# Test once without custom Addons, Gray Map modifications or overlay software.

# Note the map, character action and exact local time when it happened.

# Keep any crash message or automatic crash-report identifier shown by the client.

A single crash does not necessarily require reinstalling the client. Reinstall only after patching, graphics settings, runtimes and antivirus history have been checked.

See [[How To Play on Linux]].

Set up Wine and place the Linux patcher in the MuhRO game folder:

[https://patcher.muhro.eu/patches/patcher/linux/Muh_Patcher Muh Patcher for Linux]

If Linux reports that the file is not executable, give it execute permission before starting it. Wine and Linux distributions differ, so include the distribution, Wine version and terminal error when requesting support.

The default Windows patcher is 64-bit. A 32-bit Windows installation requires the 32-bit patcher:

[https://patcher.muhro.eu/patches/patcher/32/Muh_Patcher.exe Muh Patcher 32-bit]

Save it as <code>Muh_Patcher.exe</code> inside the game folder. A 32-bit patcher is normally not needed on 64-bit Windows.

For Windows 7 64-bit, use the dedicated legacy version:

[https://patcher.muhro.eu/patches/patcher/win7/Muh_Patcher.exe Muh Patcher for Windows 7 64-bit]

Windows 7 and Windows 8.1 are obsolete operating systems and may no longer support every modern launcher component.

A patcher pinned directly to the Windows taskbar may hide its update prompt.

# Open Task Manager and end every <code>Muh_Patcher.exe</code> and <code>updater.exe</code> process.

# Start <code>Muh_Patcher.exe</code> directly from the game folder.

# After the updated patcher starts successfully, create a normal desktop shortcut or pin the new executable again.

# Close the game and all patcher/updater processes through Task Manager.

# Start the patcher directly from the game folder rather than an old taskbar shortcut.

# Retry the update once.

If the automatic update still fails, download the correct patcher manually:

* [https://patcher.muhro.eu/patches/patcher/64/Muh_Patcher.exe Windows 64-bit, default]

* [https://patcher.muhro.eu/patches/patcher/32/Muh_Patcher.exe Windows 32-bit]

* [https://patcher.muhro.eu/patches/patcher/linux/Muh_Patcher Linux]

Save the file into the game folder and replace the existing <code>Muh_Patcher.exe</code>. Make sure the browser did not save it under a name such as <code>Muh_Patcher (1).exe</code>.

The current patcher uses Microsoft Edge WebView2, not Internet Explorer.

# Close all patcher processes.

# Install or repair the [https://developer.microsoft.com/en-us/microsoft-edge/webview2/ Microsoft Edge WebView2 Runtime].

# Start the patcher again. A fresh WebView2 profile will be created.

If this works, the renamed cache may be removed later. If it does not work, keep it until troubleshooting is complete.

Copy or screenshot the complete bottom-bar message. The final part of the error is often the most useful part.

# Retry once.

# Check the internet connection and make sure the computer's date and time are correct.

# If patch data was reset and cannot be restored, download a fresh full client.

Another patcher process, folder permissions or an unsuitable installation path may prevent patching.

# Close <code>Muh.exe</code>, <code>Muh_Patcher.exe</code> and <code>updater.exe</code> through Task Manager.

# Restart Windows if the lock remains.

# Avoid spaces, special symbols, protected Windows folders and cloud-synchronized folders.

Running permanently as Administrator is not the preferred solution. A normal user-writable game folder is safer and avoids most permission problems.

# Close the game and patcher completely.

# Check antivirus Protection History for a file removed from the MuhRO folder.

# If the same verification error remains, take a screenshot and perform a clean installation into a new folder.

Keep the old folder until the new installation works or staff has collected the required file information.

# Confirm that Windows date, time and time zone are set automatically.

# Restart the patcher instead of refreshing the login repeatedly.

# Install or repair Microsoft Edge WebView2 if the login page itself does not load.

Do not reset Internet Explorer; it is not used by the current patcher.

Security software may occasionally quarantine the patcher or a required game file because patchers download, verify and replace executable files.

A detection should not automatically be assumed to be harmless. Only restore a file when:

* MuhRO was downloaded from the official website or patcher;

* the detected path is inside the expected MuhRO installation;

* the filename matches the file reported missing by the patcher.

# Open '''Windows Security'''.

# Select '''Virus & threat protection'''.

# Start <code>Muh_Patcher.exe</code> and retry patching so the installation is verified again.

If Defender removes the file again, an exception for the exact MuhRO folder may be required. Add only the specific game folder, not an entire drive or a broad folder such as <code>C:\Games</code>.

Do not disable antivirus or firewall protection completely.

Windows Controlled Folder Access may block applications from modifying protected folders such as Desktop or Documents.

Moving MuhRO to <code>C:\Games\MuhRO</code> is normally preferable. Alternatively, allow the official <code>Muh_Patcher.exe</code> through Controlled Folder Access after checking its location.

# Check the homepage or announcements for known maintenance.

# Ensure Windows date and time are correct.

# If one connection works and another does not, tell support which internet provider and country are affected.

Do not open router ports for MuhRO unless staff provides a specific documented reason.

Use a clean reinstall only after the simpler steps above have failed.

# Close all MuhRO and patcher processes.

# Rename the current folder to something such as <code>MuhRO-old</code>. Do not delete it yet.

# Add custom maps or addons back one at a time only after the default client works.

Do not install a fresh client over a damaged or heavily modified old client. Keep screenshots and personal configuration files in the old folder until the new installation has been tested.

* Do not start <code>Muh.exe</code> directly.

* Do not download missing DLL, EXE or GRF files from third-party file websites.

* Do not send anyone your password, security code or login token.

Please include:

* a screenshot and the complete error text;

* the exact date, local time and time zone when it happened;

* the game-account name or character name when relevant.

Never include your password, security code or other private credentials.

</translate>