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:

• Caused by bad error handling in launcher.exe and a blocked domain
• See Issue#28 for solutions

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 your launcher
2. Apply the patches as described in README.md

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.

White screen freeze when entering the door

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

• Version 1.2.0: Seen after 24 Dec (except on 29/30 Dec)
• Version 1.3.0: First seen on 4 Feb

This error 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

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
  • If yes -> download winetricks
  • bash winetricks
  • Install the DLL package dxvk (newest stable version)
• Try Proton: add launcher.bat to your game library.
• PlayOnLinux: Possibly outdated DXVK. Instructions:
  • Configure game -> Install components -> [Latest DXVK version]

Mouse/keyboard input issues

Easiest solution:

• wine explorer /desktop=anyname,1920x1080 cmd /c launcher.bat (adjust to your resolution)
• Try Proton: add cmd /c launcher.bat to your game library

Lutris:

• Runner options -> Enable virtual desktop

Without a virtual desktop: (experimental)

• winecfg -> Check "Automatically capture the mouse in full-screen windows"
• regedit -> HKEY_CURRENT_USER\Software\Wine\X11 Driver set REG_SZ UseTakeFocus to N
  • Lutris already does this by default.

See also: search engine query unity wine focus

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
3. Change the resolution back to fullscreen

Weak graphics, slow game

Please keep in mind that the minimal specifications also apply for Linux. Do not expect a performance gain compared to Windows native.

1. Change the detail level to 1.0 other values may be slower
2. Lower the resolution
   • Edit launcher.bat and append following arguments:
   • -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\...
3. See also: Unity CLI args
   • -screen-quality is only applied to the first login scene, hence useless

Information sources

General information:

• PlayOnLinux