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 前缀中，某些偏好设置会在不同角色和客户端安装之间共享。保存共享设置前，补丁程序可能要求关闭所有原始客户端。

游戏设置会加载你的当前配置，并包含四个标签页：显示、音频、游戏和维护。

• 保存 会应用设置并报告结果。成功保存后窗口保持打开。
• 取消 或关闭按钮会丢弃未保存的表单编辑。
• 重置显示和音频 会将默认值放入表单。检查它们并点击保存以应用。它还会重置显示的质量以及窗口/输入选项，但保留游戏标签页的命令开关。

维护操作有各自的确认提示，确认后立即生效。关闭对话框或按下取消不会撤销已完成的维护操作。

显示

首次设置时，选择一个检测到的图形设备和适合你显示器的窗口分辨率。重置显示和音频 在可用时优先选择 DirectX 9、1280 x 720 和 32 位色。这些是初始默认值；你可以选择其他受支持的模式。

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

设置	作用
图形 API	为原始客户端选择 DirectX 7 或 DirectX 9。可用设备和模式取决于此选择和已安装的渲染器。
图形设备	选择你计算机上检测到的设备。从列表中选择一个。在更改图形驱动程序或渲染器后，请重新检查此设置。
分辨率	设置游戏的渲染尺寸。为全屏选择提供的模式。在支持的范围内，窗口化游玩可使用自定义宽度和高度。
颜色深度	选择一个可用的颜色深度，通常为 32 位或 16 位。可用性取决于设备和模式。
全屏	以全屏模式启动原始客户端。全屏和无边框窗口不能同时启用。
测试图形	打开所选模式的预览，最长持续 15 秒。按 Escape 可提前关闭。测试不会保存设置或启动你的游戏账号。
设置 Windows 高性能 GPU	设置 Windows 对游戏可执行文件的图形偏好。这个仅限 Windows 的选项在具有多个 GPU 的系统上可能有用。实际结果取决于驱动程序和硬件。

预览成功后，点击保存。如果预览失败，请先返回受支持的设备和模式，然后再试一次。

窗口和输入选项

当已安装的客户端提供 ROExt 支持时，会显示额外的控制选项。保存更改并重启游戏即可使用它们。

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

设置	作用
无边框窗口	使用没有普通边框的窗口。此模式下请保持全屏禁用。
自定义无边框尺寸	启用自定义窗口位置和尺寸字段。窗口 X 和 Y 设置其位置；窗口宽度和高度设置其尺寸。
总在最前	使游戏窗口保持在普通窗口之上。
重新映射额外鼠标按钮	启用 ROExt 的额外鼠标按钮映射。它不提供自定义绑定编辑器。
使用 Alt+PrintScreen 而不是 Alt+F4 关闭	更改 ROExt 的关闭快捷键，以减少使用 Alt+F4 时的意外关闭。
减少后台 CPU 占用	当游戏窗口处于非活动状态时减少 CPU 占用。
禁用 VSync	通过 ROExt 禁用垂直同步。这可能会改变帧节奏，并可能导致画面撕裂。
禁用屏幕淡入淡出	禁用受支持的淡出和淡入过渡。
使用 Ctrl+W 最小化	勾选此框以允许 Ctrl+W 最小化游戏窗口。取消勾选以禁用该快捷键。保存并重启游戏以应用更改。
允许光标移出游戏窗口	一个旧版兼容选项。当前 ROExt 版本未实现旧的 MouseFreedom 设置，因此此复选框在当前版本中不提供该行为。

音频

BGM 启用背景音乐，音效 启用游戏音效。两者都有一个 0 到 100 的音量滑块。

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

高级控制选项包括：

设置	选项
声音模式	无声音、2D 声音或 3D 声音。
扬声器模式	立体声、耳机、环绕声或四扬声器。
声音声道	48、32 或 16。
声音频率	22050、11025 或 8000 Hz。
声音质量	16 位或 8 位。

某些高级声音设置是旧版偏好设置，在特定客户端版本中可能没有可听效果。更改后请保存并重启游戏。如果没有声音，请检查声音模式、BGM 和音效开关、它们的音量以及 Windows 或 Wine 的音频输出。

游戏

此标签页包括三线性过滤、鼠标独占、精灵质量和纹理质量。精灵和纹理质量提供低、中、高。

The Game tab contains quality options and client command preferences.

其余复选框用于存储客户端命令偏好设置。下表列出了这些控件及其关联的命令。有些是旧版客户端功能；可用性和行为取决于客户端版本。

分组	偏好设置
输入与目标选择	战斗模式（/battlemode）、无需 Shift 使用技能（/noshift）、无需 Ctrl 攻击锁定（/noctrl）、攻击吸附（/snap）、物品吸附（/itemsnap）、技能吸附（/skillsnap）、战斗目标指引（/btg）、快捷栏 1（/q1）以及快捷栏 2（/q2）。
聊天与消息	阻止交易请求（/notrade）、技能失败消息（/skillfail）、隐藏公开聊天（/notalkmsg）、隐藏公会聊天（/notalkmsg2）以及登录消息（/loginout）。
名称与界面	显示名称（/showname）、窗口吸附（/window）、购物板（/shopping）、状态图标（/stateinfo）、怪物 HP 条（/monsterhp）、小地图（/minimap）、公会徽章（/emblem）、显示商店（/showshop）以及首次运行提示（/firstrun）。
画面与镜头	雾（/fog）、光环（/aura）、Alt 光环显示（/aura2）、Miss 显示（/miss）、效果（/effect）、镜头旋转（/camera）、光照图（/lightmap）、震动效果（/quake）、Sprite mable（/mable）、扩大视野（/zoom）以及 Mineffect（/mineffect）。
AI 偏好设置	人工生命体 AI（/hoai）以及佣兵 AI（/merai）。
旧版快捷按钮	现金商店按钮（/cashshop）、Gold PC 按钮（/goldpc）以及轮盘按钮（/roulette）。

部分标签需要额外说明：

• 无需 Ctrl 攻击锁定 允许在不按住 Ctrl 的情况下自动攻击。
• 快捷栏 1 使用右键对应 F9。快捷栏 2 使用鼠标滚轮对应 F7 和 F8。
• 隐藏公会聊天 保存更宽泛的 /notalkmsg2 偏好设置，它会隐藏聊天消息，包括公会聊天。
• 显示名称 会更改角色名字体与细节样式。它不是名称可见性开关。
• 购物板 控制单击左键打开商店、右键关闭商店。
• 状态图标 控制状态图标说明。
• 战斗目标指引 控制战场图标。
• 镜头旋转 保存镜头缩放偏好设置。
• 光环 保存客户端的简化光环偏好设置。Alt 光环显示 控制光环可见性。
• 扩大视野 是镜头缩小偏好设置。它不会增加目标选取范围。
• Sprite mable 是 Spirit Marble 效果偏好设置，在客户端消息中也称为 Sprite Marble。

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.