Patcher

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

This guide describes patcher version 1.0.45. Integrated Game Setup was introduced in version 1.0.44. Button names below use the English interface. Available options can differ between the original client and the beta client.

Getting started

1. Open the MuhRO Patcher from your game folder. Close any running game clients before installing updates.
2. 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.
3. Before your first original-client launch, open Client Tools > Game Setup. Select your graphics device and resolution, use Test graphics if needed and click Save. Close the setup window after the success message.
4. 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.

The main window

The main patcher window with the Master Account sign-in form.

Area	Purpose
Community	Opens the Forum, Wiki, Website and Discord.
Client Tools	Opens Game Setup, Turbo Setup, /greymap + LGP and Addons.
Patcher Control	Cancels an update or retries patching. The selected Patch Host controls the preferred download server.
Proxy Latency	Measures the available connection routes.
Language	Changes the patcher's interface language.
Server Status	Shows the Map, Char and Login service status alongside Players, Shops and Alts.
Latest News	Displays recent MuhRO news and announcements. Select an article to read it.
Account area	Signs in to your Master Account and displays its available game accounts.
Progress and status	Shows the current update or operation and any errors that need attention.
Version	Shows the patcher version near the bottom of the sidebar. You can select and copy it for a support request.

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.

Patching and download servers

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

• Cancel update requests cancellation of the current update. Wait for the patcher to finish cancelling.
• Retry patching starts another update attempt after an error or cancellation.
• Update Now appears when the running patcher detects new patches. Close all game clients before using it.
• Patch Host saves your preferred download server on this computer. It is tried first on the next update attempt. Other hosts can be used as fallbacks.

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.

Use the Addons and Custom GRF controls described below for supported customization. They replace the old guide's manual patch downloads and archive-editing instructions.

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.

Remember e-mail saves the e-mail address for the next sign-in. The patcher also has a separate saved launcher session that may sign you back in while it remains valid. Closing the patcher does not sign you out. Use Logout when you want to end the saved session, especially on a shared computer.

After signing in:

• Click a game account's name to launch it.
• Online and Offline show the account's reported status. An online account offers Click to Kick. This requests a disconnect; wait a few seconds before trying to launch again.
• A B marker identifies a borrowed account.
• Filter accounts searches the account list.
• Drag account rows to reorder them or use Move to top and Move to bottom. The order is stored on this computer. Reset order removes your saved order.
• Refresh Now reloads the account list and status.
• Manage opens Master Account management on the website.
• Create new Game Account opens the account creation page.

The game-account list after sign-in. These are example accounts.

Beta client

Launch beta client appears only when your account is allowed to use it. Select it before clicking a game account. The patcher downloads or verifies the required beta files before launching.

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

Open Client Tools > Game Setup to configure the original client inside the patcher. A separate OpenSetup application is no longer needed for this workflow.

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.

• Save applies the settings and reports the result. The window remains open after a successful save.
• Cancel or the close button discards unsaved form edits.
• Reset display and audio puts defaults into the form. Review them and click Save to apply them. It also resets the displayed quality and window/input options but keeps the Game tab's command toggles.

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

For a first setup, select a detected graphics device and a windowed resolution that fits your display. Reset display and audio prefers DirectX 9, 1280 x 720 and 32-bit color when these are available. These are starting defaults; you can choose a different supported mode.

The Display tab with an example graphics device and windowed resolution.

Setting	What it does
Graphics API	Selects DirectX 7 or DirectX 9 for the original client. The available devices and modes depend on this choice and the installed renderer.
Graphics device	Selects a device detected on your computer. Choose one from the list. Recheck this setting after a graphics driver or renderer change.
Resolution	Sets the game's render size. Choose an offered mode for fullscreen. Custom Width and Height are available for windowed play within the supported limits.
Color Depth	Selects an available color depth, normally 32 bit or 16 bit. Availability depends on the device and mode.
Fullscreen	Starts the original client in fullscreen. Fullscreen and Borderless window cannot be enabled together.
Test graphics	Opens a preview of the selected mode for up to 15 seconds. Press Escape to close it early. Testing does not save settings or launch your game account.
Set Windows high performance GPU	Sets Windows' graphics preference for the game executable. This Windows-only option can be useful on systems with more than one GPU. The actual result depends on the driver and hardware.

After a successful preview, click Save. If the preview fails, return to a supported device and mode before trying again.

Window and input options

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

Window options with the Minimize with Ctrl+W checkbox enabled.

Setting	What it does
Borderless window	Uses a window without the normal border. Leave Fullscreen disabled for this mode.
Custom borderless size	Enables the custom window position and size fields. Window X and Y set its position; Window Width and Height set its size.
Always on top	Keeps the game window above ordinary windows.
Remap extra mouse buttons	Enables ROExt's additional mouse-button mapping. It does not provide a custom binding editor.
Close with Alt+PrintScreen instead of Alt+F4	Changes ROExt's close shortcut to reduce accidental closes with Alt+F4.
Reduce CPU use in the background	Reduces CPU use while the game window is inactive.
Disable VSync	Disables vertical synchronization through ROExt. This may change frame pacing and can allow tearing.
Disable screen fading	Disables the supported fade-out and fade-in transitions.
Minimize with Ctrl+W	Check this box to let Ctrl+W minimize the game window. Uncheck it to disable the shortcut. Save and restart the game to apply the change.
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

BGM enables background music and Sound effects enables game sounds. Each has a volume slider from 0 to 100.

Audio device options and separate music and sound-effect volumes.

The advanced controls are:

Setting	Choices
Sound mode	No sound, 2D sound or 3D sound.
Speaker mode	Stereo, Headphones, Surround or Four speakers.
Sound channels	48, 32 or 16.
Sound frequency	22050, 11025 or 8000 Hz.
Sound quality	16 bit or 8 bit.

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.

Game

This tab includes Trilinear filtering, Mouse exclusive, Sprite quality and Texture quality. Sprite and texture quality offer Low, Medium and High.

The Game tab contains quality options and client command preferences.

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.

Group	Preferences
Input and targeting	Battle mode (/battlemode), No Shift skill use (/noshift), No Ctrl attack lock (/noctrl), Attack snap (/snap), Item snap (/itemsnap), Skill snap (/skillsnap), Battle target guide (/btg), Quick slot 1 (/q1) and Quick slot 2 (/q2).
Chat and messages	Block trade requests (/notrade), Skill failure messages (/skillfail), Hide public chat (/notalkmsg), Hide guild chat (/notalkmsg2) and Login messages (/loginout).
Names and interface	Show names (/showname), Window snap (/window), Shopping board (/shopping), Status icons (/stateinfo), Monster HP bar (/monsterhp), Minimap (/minimap), Guild emblems (/emblem), Show shops (/showshop) and First-run tips (/firstrun).
Graphics and camera	Fog (/fog), Auras (/aura), Alt aura display (/aura2), Miss display (/miss), Effects (/effect), Camera rotation (/camera), Light map (/lightmap), Quake effect (/quake), Sprite mable (/mable), Expanded sight (/zoom) and Mineffect (/mineffect).
AI preferences	Homunculus AI (/hoai) and Mercenary AI (/merai).
Legacy shortcut buttons	Cash shop button (/cashshop), Gold PC button (/goldpc) and Roulette button (/roulette).

Some labels need additional context:

• No Ctrl attack lock allows automatic attacking without holding Ctrl.
• Quick slot 1 uses right-click for F9. Quick slot 2 uses the mouse wheel for F7 and F8.
• Hide guild chat stores the broader /notalkmsg2 preference, which hides chat messages including guild chat.
• Show names changes the character-name font and detail style. It is not a name-visibility switch.
• Shopping board controls single-left-click shop opening and right-click closing.
• Status icons controls status-icon descriptions.
• Battle target guide controls the battleground icon.
• Camera rotation stores the camera-zoom preference.
• Auras stores the client's simplified aura preference. Alt aura display controls aura visibility.
• Expanded sight is the camera zoom-out preference. It does not increase targeting range.
• Sprite mable is the Spirit Marble effect preference, also called Sprite Marble in the client's messages.

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.

Maintenance actions create backups before changing the selected settings or files.

Action	Result
Reset window and chat positions	Backs up and resets saved interface and chat-window positions. Useful for windows that are misplaced or off screen.
Reset remembered skill levels	Resets the client's remembered skill-use levels. It does not reset learned skills or refund skill points.
Clear emblem cache	Moves the cached guild emblems to backup so the client can recreate its cache.
Move screenshots to backup	Moves the current screenshot folder into the dated backup.
Move replays to backup	Moves the current replay folder into the dated backup.
Move chat logs to backup	Moves the current chat-log folder into the dated backup.
Reset graphics, interface and skill levels	Backs up and resets the corresponding client options and remembered interface/skill preferences. Review and save Game Setup before launching again. This action does not erase game accounts, character progress, installed patches or your screenshot, replay and chat-log folders.

The result shows the backup location under savedata/setup-backups in your game folder. Keep this backup if you might need to recover files or settings. The included backup.json 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 Setup

Open Client Tools > Turbo Setup to edit Turbo bindings in the configuration window. Normal configuration no longer requires editing a file in Notepad.

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

1. Under Add Binding, choose the binding type.
2. Capture the key you want to use. For a skill or item, use the key assigned to its in-game hotbar slot.
3. Set the delay between repeats and click + Add.
4. Review the binding list and click Save.
5. In the game, enable Turbo with Alt+P if using the default pause key, then hold the assigned key.

Binding type	Use
Smart Left	Presses the skill key and clicks at the mouse position. Use it for skills that require a target or ground selection.
Alt+Right click	Repeats Alt+right-click. This action does not press a skill hotbar key.
Turbo	Repeats the assigned key. Use it for actions that work from the hotbar without a target click, such as suitable self-use skills or consumables.

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.

Save writes the configuration to MuhTurbo.ini. The current original client automatically reloads valid changes without needing a restart.

Profiles and other Turbo controls

• Selecting a profile loads its saved configuration. Save current edits before selecting another profile.
• Save saves edits to the selected profile. Saving an inactive profile does not activate it.
• Switch makes the selected profile active and saves it.
• New creates a named profile from the currently displayed configuration.
• Delete removes a profile. At least one profile must remain.
• The key-capture options include a numpad preference. The editor also offers Dark and Light appearance.
• INI Path and Load are advanced controls for loading a configuration file. Leave the normal path unchanged unless you specifically need to work with another configuration.

If the Turbo window opens with missing text, close it, enable Compatibility mode next to Turbo Setup in the patcher and reopen the tool. This setting affects the Turbo editor's display.

Addons

Open Client Tools > Addons to install or remove supported visual customizations. Close game clients before changing files and wait for the operation to finish. Check the reported installed state, then restart the game to see the result.

Official visual addons, renderer choices and the Custom GRF controls.

Official visual addons

Addon	Available choices
Wide Description Skin	On or Off.
Transparent Skillbar	On or Off.
Original Cursor	On or Off.
HD8Bit Damage Font	On or Off.
Hotbar Numbers	White, Black or Off.
Original Casting Circle	On or Off.

Off removes that official visual override. The appearance then comes from the remaining installed game and custom assets.

Reset official add-ons switches the official visual addons off together. It keeps your custom and gray textures and does not reset the Renderer selection.

Renderer

The Renderer row offers Default, DXVK and dgVoodoo. Default restores the renderer choice without one of these local wrappers. DXVK and dgVoodoo are alternative graphics compatibility options; their results depend on the computer and driver.

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

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

• Replace from archive replaces the saved custom collection with the selected archive and enables it.
• Merge archive adds to the saved collection and enables it. If both contain the same file path, the incoming file replaces that entry.
• Off disables the custom collection while retaining it for later.
• On re-enables the saved collection. If no collection is saved, it opens archive selection.

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.

/greymap + LGP

Open Client Tools > /greymap + LGP to install gray-map textures, customize tiles and change LGP artwork. Close the game before changing these files and restart it afterward.

Gray-map sources, custom tiles and LGP image controls. Scroll within the panel for more options.

Gray-map textures

1. Choose the built-in Gray or Vik Green source.
2. Click Install / Replace and wait for the success message.
3. Launch the game and use /greymap to toggle the installed gray textures.

Clear installed gray empties the installed gray texture archive. Use the in-game /greymap command when you only want to turn the display off temporarily. The patcher does not show whether the in-game toggle is currently on.

Replace from archive installs a compatible custom gray texture set. Merge archive adds compatible textures to the existing set. Keep your source archive if you might want to reinstall it later.

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

You can choose images for Walkable, Blocked, Water and Snipable tiles.

Choose an image for each tile type you want to change, then apply the selected images.

1. Use Choose image for each tile type you want to change.
2. Review the selected images.
3. Click Apply selected images and wait for completion.
4. Restart the game and use /greymap.

Only the selected tile types change. Reset returns one tile type to its built-in artwork. Empty or void areas use the blocked tile.

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

The LGP section changes the artwork for Circle, Square, All skill floors or an individual skill's floor image.

1. 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.
2. Select the image or skill to change. Search by name, skill ID or effect ID if needed.
3. Use Choose image, inspect the selection and click Install image.
4. Restart the game to load the changed artwork.

Seen last session filters the list to floor skills recorded during your last game session. If the list is empty, play a session containing floor skills first. Individual skill images take priority over the All skill floors artwork.

LGP imports accept PNG or BMP up to 8 MB and 2048 x 2048 pixels. Transparency is preserved. Reset image removes the selected custom override. A reset skill can then use your All skill floors artwork if you have customized it. Restore all originals removes the custom LGP artwork while keeping unrelated custom assets.

Proxy Latency

Open Proxy Latency to compare measured connection routes. Refresh repeats the measurement. Best marks the route with the lowest calculated score in that measurement.

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

Automatically send crash diagnostics controls automatic report uploads where supported. It is enabled by default. Turning it off keeps reports local instead of uploading them automatically.

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.

Troubleshooting

Problem	What to check
Login or game launch is unavailable	Wait for patching to finish. Read the current status or error. If an update is required, close game clients and complete it.
Game Setup keeps opening before launch	Select a detected device and supported mode, then Save. Close the window after the success message. A preview or Cancel does not save the configuration.
No graphics device or an unsupported renderer is reported	Check Addons > Renderer and select a supported option. Reopen Game Setup afterward. Original-client graphics detection on Linux requires a working Wine environment.
Graphics fail after changing renderer or driver	Reopen Game Setup and review the detected device. Try a supported windowed mode and Test graphics, then Save. Reset display and audio can refill the form with defaults.
Saving reports that settings changed elsewhere	Close other setup tools and game clients. Close and reopen Game Setup to load the current values, then make the changes again.
Saving reports a permissions or shared-settings error	Follow the exact error. Close every original client when requested. If it persists, send support the error text and patcher version.
A game account still shows Online	Use Click to Kick if you intend to disconnect it, wait a few seconds and Refresh Now before trying again.
Turbo does nothing	Check the binding key, hotbar assignment and active profile. Save the configuration and enable the controller with Alt plus its Pause Key. Hold the binding key while the game is focused. Restart the game if it has not picked up the saved configuration.
Turbo Setup has missing text	Close the tool, enable its Compatibility mode in the patcher and reopen it.
An addon or LGP image is not visible	Check that the operation succeeded and restart the game. Check Custom GRF state and possible overlapping custom assets.
Gray textures have not changed	Confirm that textures are installed, restart the game and check the in-game /greymap toggle. Installing textures and enabling their display are separate steps.
Interface or chat windows are misplaced	Close the game and use Game Setup > Maintenance > Reset window and chat positions. Keep the reported backup.

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.