Patcher/zh-hans

MuhRO Patcher 会更新你的游戏、登录你的 Master Account，并提供配置和自定义客户端的工具。

本指南介绍 Patcher 版本 1.0.45。集成的 Game Setup 是在 1.0.44 版中引入的。以下按钮名称使用英文界面。可用选项可能会因原版客户端和 beta 客户端而有所不同。

开始使用

1. 从你的游戏文件夹中打开 MuhRO Patcher。安装更新前，请关闭所有正在运行的游戏客户端。
2. 等待更新完成。如果更新失败，请阅读状态消息。在所需更新完成之前，无法登录或启动游戏。
3. 首次启动原版客户端前，请打开 Client Tools > Game Setup。选择你的图形设备和分辨率，如有需要请使用 Test graphics，然后点击 Save。看到成功消息后关闭设置窗口。
4. 输入你的 Master Account 电子邮箱地址和密码。登录后，点击你想要游玩的游戏账号名称。

Patcher 会在启动前检查原版客户端已保存的图形设置。设置缺失或无效时会打开 Game Setup，并且必须成功保存后才能继续。仅仅打开或取消该窗口并不会完成设置。现有的有效设置可以重复使用。

保存设置不会自动启动游戏。准备好后，关闭 Game Setup 并选择你的游戏账号。

主窗口

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

区域	用途
Community	打开 Forum、Wiki、Website 和 Discord。
Client Tools	打开 Game Setup、Turbo Setup、/greymap + LGP 和 Addons。
Patcher Control	取消更新或重试更新。所选的 Patch Host 控制首选下载服务器。
Proxy Latency	测量可用的连接线路。
Language	更改 Patcher 的界面语言。
Server Status	显示 Map、Char 和 Login 服务状态，以及 Players、Shops 和 Alts。
Latest News	显示最近的 MuhRO 新闻和公告。选择一篇文章即可阅读。
Account area	登录你的 Master Account 并显示其可用的游戏账号。
Progress and status	显示当前更新或操作，以及任何需要注意的错误。
Version	在侧边栏底部附近显示 Patcher 版本。你可以选择并复制它，以便提交支持请求。

语言选择器提供 System language、English、German、French、Spanish、Portuguese、Russian、Czech、Japanese、Malay、Indonesian 和 Thai。更改语言会保留你的启动器会话。它更改的是 Patcher 界面，而不是游戏语言或每个单独的配置工具。

更新与下载服务器

Patcher 在打开时会检查更新。请保持其打开，直到操作完成且状态报告已就绪。

• Cancel update 请求取消当前更新。等待 Patcher 完成取消。
• Retry patching 在出现错误或取消后开始另一次更新尝试。
• Update Now 会在运行中的 Patcher 检测到新补丁时出现。使用前请关闭所有游戏客户端。
• Patch Host 将你偏好的下载服务器保存在这台电脑上。下次更新尝试时会优先使用它。其他主机可作为备用。

在 LIVE 上，可用的下载主机包括 Patcher EU、Patcher EU 2 和 Patcher NA。TEST Patcher 有自己的主机列表。更改 Patch Host 会影响补丁下载。它不会选择你的游戏内代理。

如果更新失败，请阅读错误信息、关闭正在运行的客户端并重试。如果下载仍不稳定，请选择另一个 Patch Host 并重试。寻求帮助时，请附上确切的错误信息和 Patcher 版本。

使用下面介绍的 Addons 和 Custom GRF 控件进行受支持的自定义。它们取代了旧指南中手动下载补丁和编辑压缩包的说明。

登录并启动游戏账号

使用你的 Master Account 电子邮箱地址和 Master Account 密码登录。单个游戏账号的用户名和密码不是此表单的凭据。

Remember e-mail 会保存电子邮箱地址以便下次登录。Patcher 还有一个单独的已保存启动器会话，在有效期间可能会让你自动重新登录。关闭 Patcher 不会将你登出。当你想结束已保存的会话时，请使用 Logout，尤其是在共用电脑上。

登录后：

• 点击游戏账号名称即可启动。
• Online 和 Offline 显示账号的报告状态。在线账号会提供 Click to Kick。这会请求断开连接；请等待几秒后再尝试启动。
• B 标记表示借用的账号。
• Filter accounts 搜索账号列表。
• 拖动账号行可重新排序，或使用 Move to top 和 Move to bottom。顺序保存在这台电脑上。Reset order 会移除你保存的顺序。
• Refresh Now 重新加载账号列表和状态。
• Manage 在网站上打开 Master Account 管理。
• Create new Game Account 打开账号创建页面。

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

Beta 客户端

Launch beta client 仅在你的账号被允许使用时出现。点击游戏账号前请先选择它。Patcher 会在启动前下载或验证所需的 beta 文件。

在新的 Patcher 会话中，该复选框默认未勾选。原版客户端的 Game Setup 不会配置 beta 客户端的图形。请使用 beta 客户端自己的设置来配置该客户端。

Game Setup

打开 Client Tools > Game Setup，即可在 Patcher 内配置原版客户端。此工作流程不再需要单独的 OpenSetup 应用程序。

更改设置前，请关闭正在运行的原始客户端。在同一 Windows 环境或 Wine 前缀中，某些偏好设置会在不同角色和客户端安装之间共享。保存共享设置前，补丁程序可能要求关闭所有原始客户端。

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.