Skip to content

Troubleshoot Game

Jump to bottom
Marie edited this page Aug 25, 2022 · 1 revision

Sorted by appearance from installation (top) to gameplay (bottom).

List of problematic Wine versions

  • Wine 7.5+: Broken batch file execution; stuck with find.exe. See below
  • Wine 7.3 - 7.5: May require a manual wineprefix update. See below
  • Wine 6.21 (Lutris?): Possible freeze before login screen
  • Wine 6.15 (vanilla): Crash when entering or leaving multiplayer
  • Wine 6.14: Suspected audio playback problems
  • Wine 6.10: Crash in HID when using a controller
  • Wine 6.0 (staging): Possible stutter issues on AMD graphics
  • Wine 5.19: Occasional crash while preparing media (login screen)
  • Wine 5.3 and older: Missing StartThreadpoolIo implementation

'find' or 'start' cannot be found

Alternatively: notepad.exe opens on launch, displaying an error message.

Possible causes:

  • Old Lutris Wine package (prior to "lutris-6.4")
  • Incomplete or corrupted WINEPREFIX setup

Solutions:

  • Try another package, such as Proton or newer Lutris Wine.
  • Use a new WINEPREFIX. Move the game installation.

Game crashes on launch

  1. Ensure the patch is applied
  2. Retry without kernel sync (ESYNC, FSYNC, ...)

Game crash related to the wineprefix

Wine output log example:

  • wine: Call from XXXXXX to unimplemented function combase.dll.RoSetErrorReportingFlags, aborting

This applies to Wine 7.3 or newer but not Proton. Either:

  • Delete the old WINEPREFIX and create a new one then retest
    • The game installation should be located outside any prefix to avoid accidental deletion.

Game no longer works on Windows

  • This is intentional to avoid abuse of this project
  • If you are Dual-Booting, write a batch script to swap the game files as needed

StartThreadpoolIo not found in KERNEL32.dll

  • Use Wine 5.3 or newer. This function has been added recently.

Login shows a white rectangle

After activating the "Login" button, a white rectangle appears. If the Captcha does not appear after 20 seconds, check for solutions in the following Troubleshooting entries:

  • "Error 4206"
  • "In-game browser looks weird or crashes the game"

Error 4206 or "Connection timed out"

Possible error sources:

  • Faulty DNS server
  • Domain(s) blocked by ISP
  • Custom domain block lists (albeit unlikely)

In rare cases, this issue may be weekday-dependent for unknown reasons.

Solutions: tab "PC client issues"

  • Manually specify Domain Name Server (DNS) addresses
  • Use a VPN

Freeze when loading game data

Unknown cause.

  • Ensure that an audio output device is enabled
  • Try another graphics driver or setup a clean, new WINEPREFIX

Crash after 20 seconds due to sound output

First seen in version 2.1.0 using PulseAudio.

Check whether the terminal output (WINEDEBUG value is irrelevant) contains following line:

  • INFO: OpenAudioDevice failed: Unsupported number of audio channels

.. and change the sound output settings to Analog Stereo.

An error code appears

Common errors and possible causes. x stands for any number:

  • -900x
    • Out of free storage
    • Check the read and write permissions of the entire game directory, and the Persistent sub-directory in particular
  • -9908
    • The downloaded data is corrupt. Try a wired connection.

Crash when initially loading the world (7 symbols)

... + error.log message containing XAudio2_7.dll caused an Access Violation (0xc0000005)

Rare occurrence related to an audio failure. Observed in Wine 5.22 and newer.

  1. Restart the game
  2. Check for music and button sound effects

This crash might also occur when WineD3D is used rather than DXVK.

ZFGameBrowser crash

  • Ignore and restore the game window
  • For input issues: try the virtual desktop (see below)

Graphics bugs/issues

Check whether your GPU supports Vulkan: unofficial list, Intel, nVIDIA, AMD

Repair instructions:

  • Open Settings and change DXVK version

To confirm whether DXVK is working, check the section "Game is on an LSD trip".

Game is on an LSD trip

(This means that surfaces have very distinct colors)

This issue is often caused by an outdated or missing DXVK installation.

How to check (general approach):

  • Launch with DXVK Hud enabled
    • A HUD must appear in the top left corner
  • Check whether version 1.7.3 or newer is shown
  • For Repair hints check the section "Graphics bugs/issues" above.

Intel iGPU specific issues:

  • Update Mesa to a recent version, newer is better
  • See Release Notes for "ANV" mentions and fixes
  • See Issue #152 for the original report.

In case software rendering, i.e. llvmpipe is used by accident. This is most common on AMD GPUs:

  1. Check whether software rendering is used
    • Either: search for lavapipe in the terminal output upon launch
    • Or: search for Device name + llvmpipe in output_log.txt after launch
  2. Install proper Vulkan packages:
  3. Repeat step 1 to confirm your changes

Mouse/keyboard input issues

Inputs ignored after focus loss: (Unity framework specifc)

  • Use Alt+Enter to toggle to windowed mode
  • Drag the window, focus the desktop, focus the game window (again)
  • When the title bar indicates focus, switch back to fullscreen mode

See also: search engine query unity wine focus

Too high mouse sensitivity

This workaround is meant for overall high mouse sensitivity. In case this issue occurs only after switching between workspaces, check the sections below.

Disable MouseWarpOverride using Winetricks(can be opened through settings)

Alt + Mouse click not working

Cinnamon users:

Xfce4 users:

  • Same solution as in the causes the view to "spin" issue below

Switching between workspaces causes the view to "spin"

Change the in-game resolution setting:

  1. Focus the (virtual) desktop
  2. Focus the game window again. The title bar must be marked as active (blue).
  3. Change the resolution back to fullscreen

Alternative: use Proton.

Weak graphics, slow game

This may also be caused by software rendering. Check Game is on an LSD trip above.

For hybrid graphics (dGPU + iGPU) in laptops:

  1. Use the environment variable DXVK_HUD=version,devinfo,fps
  2. If the dGPU (such as nVIDIA or AMD) is shown, go to the section "Game is on an LSD trip".
  3. If the iGPU (Intel or AMD integrated) is shown:
    • For nVIDIA: Launch Wine with prime-run
    • ^ If pvkrun does not work, uninstall bumblebee prior to installing prime-run
    • For AMD: Use the environment variable PRIME_RUN=1
  4. Repeat the check in step 1

Locale-specific keyboard layout not working

Upon input, question mark signs (?) appear rather than the typed characters.

Add the environment variable LANG with your locale as value

Voiced cutscenes lack audio playback

"Feedback" and "Special Event" buttons crash Wine

These menu buttons are broken since their introduction. Following workarounds exist:

"Feedback" button:

  1. Check your in-game mail. It should contain a working URL.
    • Important: zfgamebrowser.exe must still be running (default)
  2. If there is no mail, wait for the reminder (arrives a few days).

"Special Event" button:

  1. Check the in-game browser for event links.
    • This is unreliable and might crash Wine in some cases
  2. Obtain the link from official channels or community. (e.g. Twitter)

Crash when joining co-op

See "White screen freeze when entering the door".

Clone this wiki locally