GI-on-Linux/TROUBLESHOOTING.md

Troubleshooting

To add new solutions, please open a pull request, issue or contact me directly.

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

Launcher: Game download issues

Download timeout, stuck at 0%:

• Sep/Oct 2020 launcher bug. Download the newest version and retry

Download works but launcher freezes/crashes midway:

• Use the custom Update & Patch Script as an alternative to the official launcher
• Caused by bad error handling in launcher.exe and a blocked domain
• See Issue#28 for solutions

Launcher: Useless voiceover packs get downloaded

For slow download connections, you might not want to download everything. Steps to skip downloading unwanted voiceover/language packs:

1. Locate the file audio_lang_* (where * stands for the newest) inside your game data files
2. Remove the unwanted pack lines (except maybe English(US)?)
3. Save
4. Navigate to StreamingAssets/Audio/GeneratedSoundBanks/Windows/
5. Remove the pack directories that are no longer contained within audio_lang_*`
6. Proceed to download the archives

Launcher: Failed to unzip game files

1. Check for launcher updates
2. Edit /path/to/Genshin Impact Game/config.ini
3. Adjust the line game_version=X.X.X to the currently installed version
4. Re-run the launcher to install the update

Alternatively: re-download the entire game. See Issue#28 for direct links.

Game does not start at all

1. Check & update the game version in the official launcher
2. Apply the patches as described in README.md

Lutris: 'find.exe' cannot be found, notepad opens on start

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

Some Lutris Wine packages prior to the version "lutris-6.4" either refuse to run those applications or do not ship them in first place. Try another package, such as Proton or stock/vanilla Wine.

For more details, see Issue#78.

Game crashes on launch

1. Ensure the patch is applied
2. Retry without kernel sync (ESYNC, FSYNC, ...)
3. Lutris: disable "Lutris Runtime" (for reference)

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.
• For more details, see Issue#12.

Freeze when loading game data

Unknown cause. Please submit ideas to Issue#90

• Ensure that an audio output device is enabled
• Run the game using -nolog: ??? cmd /c launcher.bat -nolog
• Try another graphics driver or setup a clean, new WINEPREFIX

White screen freeze when entering the door

... plus error log "err:virtual:virtual_setup_exception stack overflow".

Starting from version 1.2.0, this error reappears a few days after each release. It is caused by server-sent bytecode.

Workaround:

bash "/path/to/GI-on-Linux/GAMEVER/patch_anti_logincrash.sh"

Crash when initially loading the world (7 symbols)

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.

• Check the setup instructions again

Crash after a few seconds in-game

... + error.log message containing HID.DLL caused an Access Violation (0xc0000005)

This error is caused by (at least) Wine 6.10 when using a controller.

• Either: change to another Wine version (for example 6.9)
• Or: switch to keyboard & mouse.

DumpFile-zfbrowser*.dmp is generated

First found in Wine 6.10. Other versions might not crash the Chromium framework (zf_cef).

In-game browser looks weird or crashes the game

• winetricks corefonts
• Ubuntu/Debian: install ttf-mscorefonts-installer
• Re-install dxvk (if present)
• Try running the game in a virtual desktop

Other font installations might work as well as long Fontconfig can use them as fallback.

ZFGameBrowser crash

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

For more details, see Issue#29.

Graphics bugs/issues

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

Setup instructions:

• Custom script:
  • Download winetricks
  • export WINEPREFIX=/absolute/path/ (if needed)
  • sh winetricks
  • Install the DLL package dxvk (newest, or 1.7.3 for Proton 5.13)
• Lutris: Configure -> Runner options -> "Enable DXVK" and specify the version
• Proton: See setup instructions
• PlayOnLinux: (outdated DXVK?)
  • Configure game -> Install components -> [Latest DXVK version]

Game is on an LSD trip

(This means that surfaces have very distinct colors)

Generally for DXVK:

• Launch with the environment variable DXVK_HUD=version,devinfo,fps
• Check whether version 1.7.3 or newer is shown

For Intel iGPU:

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

For dedicated graphics (llvmpipe):

1. Check whether lavapipe appears in the terminal when launching the game
2. Install proper Vulkan packages:
   • Check tutorials, such as LinuxConfig or Arch Wiki
3. lavapipe must no longer appear in the terminal output

Mouse/keyboard input issues

Easiest solution:

• Adjust the following resolution numbers to your needs
• wine explorer /desktop=anyname,1920x1080 cmd /c launcher.bat (system-wide Wine)
• Steam + Proton: See setup instructions

Lutris:

• Runner options -> Enable virtual desktop

Without a virtual desktop: (experimental)

• winecfg -> Check "Automatically capture the mouse in full-screen windows"
• WINEPREFIX="/path/to/prefix" winetricks usetakefocus=n
  • Lutris already does this by default.

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:

WINEPREFIX="/path/to/prefix" winetricks mwo=disable

Alt + Mouse click not working

Cinnamon users:

• Workaround: Disable the window move & resize feature
  • See Linux Mint forums

Xfce4 users:

• Same solution as in the causes 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.

Wrong window resolution

• Append following arguments after launcher.bat:
  • -screen-width XXX -screen-height YYY -screen-fullscreen 1
• Alternative: -show-screen-selector to change the settings on startup
• Alternative: change the virtual desktop's size (if present)
• Alternative: use regedit to change the keys in HKCU\Software\...

See also: Unity CLI args

Weak graphics, slow game

For performance improving tweaks see TWEAKS.md.

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
   • For AMD: Use the environment variable PRIME_RUN=1
4. Repeat the check in step 1

Note: If Lutris is used, environment variables can be specified in the System options tab

Information sources

General information:

• PlayOnLinux