Patcher: Difference between revisions

<languages/>

<translate>

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

# 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 patcher checks the original client's saved graphics settings before launch. Missing or invalid settings open Game Setup and must be saved successfully before you can continue. Merely opening or cancelling the window does not complete setup. Existing valid settings can be reused.

Saving settings does not start the game automatically. Close Game Setup and choose your game account when you are ready.

{| class="wikitable"

! Area !! Purpose

|}

The language selector offers System language, English, German, French, Spanish, Portuguese, Russian, Czech, Japanese, Malay, Indonesian and Thai. Changing it keeps your launcher session. It changes the patcher interface rather than the game's language or every separate configuration tool.

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.

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.

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.

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.

{| class="wikitable"

! Setting !! What it does

|}

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

{| class="wikitable"

! Setting !! What it does

| 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.

|}

The advanced controls are:

{| class="wikitable"

! Setting !! Choices

|}

Some advanced sound settings are legacy preferences and may have no audible effect in a particular client build. Save and restart the game after changing them. If sound is missing, check Sound mode, the BGM and Sound effects switches, their volumes and the Windows or Wine audio output.

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.

{| class="wikitable"

! Group !! Preferences

|}

Some labels need additional context:

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"

! Action !! Result

|}

The result shows the backup location under <code>savedata/setup-backups</code> in your game folder. Keep this backup if you might need to recover files or settings. The included <code>backup.json</code> records the action and restoration information. There is no automatic Restore button in Game Setup; ask support if you need help restoring a backup.

Interface positions and remembered skill levels can be shared across all original clients and characters using the same Windows environment or Wine prefix.

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.

# 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.

{| class="wikitable"

! Binding type !! Use

|}

Each key should have one binding. Existing rows let you change the type, key and delay or delete the binding. Delays are in milliseconds and can range from 1 to 10000. The initial default is 10 ms. A delay is the minimum wait after an action, not a guaranteed cast rate. A shorter delay does not remove skill cooldowns, cast times or server restrictions.

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.

* 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.

{| class="wikitable"

! Addon !! Available choices

|}

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.

Headgear, NPC, monster and class sprite replacements are not permitted. Importing an archive does not change those customization rules.

Custom assets can take priority over official visual addons. If an addon appears unchanged, temporarily turn Custom GRF off and restart the game to check for an overlapping custom file.

Older manual downloads for a transparent menu or original textures do not have their own official addon buttons. A compatible permitted asset archive can be imported through Custom GRF. Old links and archives should not be assumed to work with the current client.

# 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.

# 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.

# 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.

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.

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.

{| class="wikitable"

! Problem !! What to check

|}

For support, copy the patcher version and the exact status or error message. Include your operating system, selected renderer and the steps that reproduce the problem. A screenshot of the error can help; hide account details and never include your password.

</translate>