Patcher: Difference between revisions

The MuhRO Patcher updates your game, signs you into your Master Account and provides the tools for configuring and customizing the client.

== Getting started ==

# Open the MuhRO Patcher from your game folder. Close any running game clients before installing updates.

# Wait for patching to finish. Read the status message if an update fails. Signing in and starting the game are unavailable until the required updates are complete.

# Enter your Master Account e-mail address and password. After signing in, click the name of the game account you want to play.

== The main window ==

{| class="wikitable"

The patcher checks for updates when it opens. Keep it open until the operation finishes and the status reports that it is ready.

On LIVE, the available download hosts include Patcher EU, Patcher EU 2 and Patcher NA. The TEST patcher has its own host list. Changing Patch Host affects patch downloads. It does not choose your in-game proxy.

If an update fails, read the error, close running clients and retry. If downloads remain unreliable, select another Patch Host and retry. Include the exact error and patcher version when asking for help.

== Signing in and launching a game account ==

Sign in with your Master Account e-mail address and Master Account password. An individual game account's username and password are not the credentials for this form.

After signing in:

* Click a game account's name to launch it.

=== Beta client ===

The checkbox starts unchecked in a new patcher session. The original client's Game Setup does not configure the beta client's graphics. Use the beta client's own settings for that client.

== Game Setup ==

Close running original clients before changing settings. Some preferences are shared across characters and client installations in the same Windows environment or Wine prefix. The patcher may require every original client to be closed before saving shared settings.

Game Setup loads your current configuration and contains four tabs: Display, Audio, Game and Maintenance.

Maintenance actions have their own confirmation and take effect immediately after confirmation. Closing the dialog or pressing Cancel does not undo a completed maintenance action.

=== Display ===

{| class="wikitable"

|}

==== Window and input options ====

Additional controls are shown when the installed client provides ROExt support. Save changes and restart the game to use them.

{| class="wikitable"

| Disable screen fading || Disables the supported fade-out and fade-in transitions.

|-

|-

| Allow cursor outside the game window || A legacy compatibility option. The current ROExt build does not implement the old MouseFreedom setting, so this checkbox does not provide that behavior in the current build.

=== Audio ===

The advanced controls are:

=== Game ===

The remaining checkboxes store client command preferences. The table lists the controls and their associated commands. Some are legacy client features; availability and behavior depend on the client build.

Some labels need additional context:

=== Maintenance and backups ===

Use Maintenance when a specific client preference or cache needs repair. Read the confirmation before continuing. Close the game first so it cannot write old settings back or keep files open.

{| class="wikitable"

== Turbo Setup ==

Turbo repeats a configured action while you hold its assigned key, the controller is enabled and the game is focused. Release the key to stop repeating. Use the pause shortcut while the game is focused to turn the controller on or off. The default Pause Key is P, making the shortcut Alt+P. The default starting state is Off.

=== Adding and editing bindings ===

# Capture the key you want to use. For a skill or item, use the key assigned to its in-game hotbar slot.

# In the game, enable Turbo with Alt+P if using the default pause key, then hold the assigned key.

You can change the Pause Key, Default State and Default Delay. The pause shortcut uses Alt plus the configured Pause Key. Changing Default Delay does not rewrite the delays already set on existing bindings. Changing Default State also updates the enabled state in a running client.

=== Profiles and other Turbo controls ===

* Selecting a profile loads its saved configuration. Save current edits before selecting another profile.

* The key-capture options include a numpad preference. The editor also offers Dark and Light appearance.

== Addons ==

=== Official visual addons ===

|}

=== Renderer ===

The Renderer choice and Game Setup's Graphics API are separate settings. After changing Renderer, reopen Game Setup, review the detected graphics device and mode, test if needed and save. An unrecognized custom renderer can prevent graphics detection; select a supported Renderer option before trying again.

Custom GRF is the supported place for permitted custom asset archives. You do not need to edit <code>GRF.INI</code> or merge changes into the patcher's managed game archives.

Supported input formats are GRF, GPF, ZIP, RGZ and compatible additive THOR archives. Imports are checked before installation. Protected content and malformed archives are rejected. THOR files that delete content or do not merge into a GRF are not supported here. This is an asset importer, not a DLL or executable installer.

== /greymap + LGP ==

=== Gray-map textures ===

# Launch the game and use <code>/greymap</code> to toggle the installed gray textures.

Gray imports accept recognized gray-grid BMP textures. Ordinary world textures, map geometry, scripts, effects and sprites do not belong in this importer. Map shapes and movement permissions remain server-controlled.

=== Custom tiles ===

# Review the selected images.

# Restart the game and use <code>/greymap</code>.

Images must be PNG or BMP, at most 8 MB and no larger than 2048 x 2048 pixels. Tile artwork is converted to 32 x 32 pixels without transparency. Changing a tile's image does not change where your character can move or attack.

=== LGP images ===

# Close the game. If you previously turned Custom GRF off, turn it back on in Addons. No separate archive is needed for your first LGP image.

# Select the image or skill to change. Search by name, skill ID or effect ID if needed.

# Restart the game to load the changed artwork.

== Proxy Latency ==

The results can include estimated route delay, hop delay and failed connection probes shown as loss. This loss value is not a direct measurement of in-game packet loss. Conditions can change, so the lowest result is not a guarantee of the best connection throughout a game session. This window measures routes; clicking or refreshing it does not select your in-game proxy.

== Crash diagnostics ==

The patcher can show whether reports were sent, retained or are waiting for another attempt. If you report a crash to support, include what you were doing and the approximate time even when automatic diagnostics are enabled.