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

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:

• See Issue#28 for solutions

Game does not start at all

1. Check & update the game version in your launcher
2. Apply the correct modifications

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

Seen after 24 Dec (except on 29/30 Dec). This error is caused by server-sent bytecode. Workaround:

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

For more details, see Issue#23.

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

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.

Mouse/keyboard input issues

Easiest solution:

• wine explorer /desktop=anyname,1920x1080 cmd /c launcher.bat (adjust to your resolution)

Lutris:

• Runner options -> Enable virtual desktop

Without a virtual desktop: (experimental)

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

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
   • or change the virtual desktop's size (if present)
3. See also: Unity CLI args
   • -screen-quality is only applied to the first login scene, hence useless

Information sources

General information:

• PlayOnLinux