Patcher/id: Difference between revisions

<div lang="en" dir="ltr" class="mw-content-ltr">

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

<div lang="en" dir="ltr" class="mw-content-ltr">

== Signing in and launching a game account ==

<div lang="en" dir="ltr" class="mw-content-ltr">

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.

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

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.

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.

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

<div lang="en" dir="ltr" class="mw-content-ltr">

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

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

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

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

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.

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

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 (<code>/battlemode</code>), No Shift skill use (<code>/noshift</code>), No Ctrl attack lock (<code>/noctrl</code>), Attack snap (<code>/snap</code>), Item snap (<code>/itemsnap</code>), Skill snap (<code>/skillsnap</code>), Battle target guide (<code>/btg</code>), Quick slot 1 (<code>/q1</code>) and Quick slot 2 (<code>/q2</code>).

| Chat and messages || Block trade requests (<code>/notrade</code>), Skill failure messages (<code>/skillfail</code>), Hide public chat (<code>/notalkmsg</code>), Hide guild chat (<code>/notalkmsg2</code>) and Login messages (<code>/loginout</code>).

| Names and interface || Show names (<code>/showname</code>), Window snap (<code>/window</code>), Shopping board (<code>/shopping</code>), Status icons (<code>/stateinfo</code>), Monster HP bar (<code>/monsterhp</code>), Minimap (<code>/minimap</code>), Guild emblems (<code>/emblem</code>), Show shops (<code>/showshop</code>) and First-run tips (<code>/firstrun</code>).

| Graphics and camera || Fog (<code>/fog</code>), Auras (<code>/aura</code>), Alt aura display (<code>/aura2</code>), Miss display (<code>/miss</code>), Effects (<code>/effect</code>), Camera rotation (<code>/camera</code>), Light map (<code>/lightmap</code>), Quake effect (<code>/quake</code>), Sprite mable (<code>/mable</code>), Expanded sight (<code>/zoom</code>) and Mineffect (<code>/mineffect</code>).

| AI preferences || Homunculus AI (<code>/hoai</code>) and Mercenary AI (<code>/merai</code>).

| Legacy shortcut buttons || Cash shop button (<code>/cashshop</code>), Gold PC button (<code>/goldpc</code>) and Roulette button (<code>/roulette</code>).

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 <code>/notalkmsg2</code> 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.

<div lang="en" dir="ltr" class="mw-content-ltr">

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

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

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.

<div lang="en" dir="ltr" class="mw-content-ltr">

=== Adding and editing bindings ===

# Under '''Add Binding''', choose the binding type.

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

# Set the delay between repeats and click '''+ Add'''.

# Review the binding list and click '''Save'''.

# 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 <code>MuhTurbo.ini</code>. The current original client automatically reloads valid changes without needing a restart.

<div lang="en" dir="ltr" class="mw-content-ltr">

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

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.

<div lang="en" dir="ltr" class="mw-content-ltr">

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

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

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

<div lang="en" dir="ltr" class="mw-content-ltr">

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.

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.

<div lang="en" dir="ltr" class="mw-content-ltr">

=== Gray-map textures ===

# Choose the built-in '''Gray''' or '''Vik Green''' source.

# Click '''Install / Replace''' and wait for the success message.

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

'''Clear installed gray''' empties the installed gray texture archive. Use the in-game <code>/greymap</code> 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.

<div lang="en" dir="ltr" class="mw-content-ltr">

=== Custom tiles ===

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

# Use '''Choose image''' for each tile type you want to change.

# Review the selected images.

# Click '''Apply selected images''' and wait for completion.

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

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.

<div lang="en" dir="ltr" class="mw-content-ltr">

=== LGP images ===

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

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

# Use '''Choose image''', inspect the selection and click '''Install image'''.

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

<div lang="en" dir="ltr" class="mw-content-ltr">

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

<div lang="en" dir="ltr" class="mw-content-ltr">

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

<div lang="en" dir="ltr" class="mw-content-ltr">

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