To add new solutions, please open a pull request, issue or contact me directly.
Sorted by appearance from installation (top) to gameplay (bottom).
Download timeout, stuck at 0%:
Download works but launcher freezes/crashes midway:
/path/to/Genshin Impact Game/config.ini
game_version=X.X.Xto the currently installed version
Alternatively: re-download the entire game. See Issue#28 for direct links.
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.
After activating the "Login" button, a white rectangle appears. If the Captcha does not appear after 20 seconds, check the solutions for "Error 4206".
Possible error sources:
In rare cases, this issue may be weekday-dependent for unknown reasons.
Solutions: tab "PC client issues"
Unknown cause. Please submit ideas to Issue#90
??? cmd /c launcher.bat -nolog
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.
Common errors and possible causes.
x stands for any number:
Persistentsub-directory in particular
... 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.
Rare occurrence related to an audio failure. Observed in Wine 5.22 and newer.
This crash might also occur when WineD3D is used rather than DXVK.
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.
Obsolete. Observed in Wine 6.10 only.
Other font installations might work as well as long Fontconfig can use them as fallback.
For more details, see Issue#29.
export WINEPREFIX=/absolute/path/(if needed)
dxvk(newest, or 1.7.3 for Proton 5.13)
(This means that surfaces have very distinct colors)
Generally for DXVK:
For Intel iGPU:
When software rendering (
llvmpipe) is used (most common on AMD GPUs):
lavapipein the terminal output upon launch
Easiest solution: Use a virtual desktop.
wine explorer /desktop=anyname,1920x1080 cmd /c launcher.bat
Without a virtual desktop: (experimental)
WINEPREFIX="/path/to/prefix" winetricks usetakefocus=n
See also: search engine query
unity wine focus
This workaround is meant for overall high mouse sensitivity. In case this issue occurs only after switching between workspaces, check the sections below.
MouseWarpOverride using Winetricks:
WINEPREFIX="/path/to/prefix" winetricks mwo=disable
causes the view to "spin"issue below
Change the in-game resolution setting:
Alternative: use Proton.
If the in-game settings are not accessible, do one of the following:
-screen-width XXX -screen-height YYY -screen-fullscreen 1
-show-screen-selectorto change the settings on startup
See also: Unity CLI args
For performance improving tweaks see TWEAKS.md.
This may also be caused by software rendering. Check
Game is on an LSD trip above.
For hybrid graphics (dGPU + iGPU) in laptops:
Note: If Lutris is used, environment variables can be specified in the
System options tab
Upon input, question mark signs (
?) appear rather than the typed characters.
Gnome: Move the locale-specific layout to second place
Change the environment variable
LANG to your locale
LANG=your_LOCALE.UTF8 wine ....
your_LOCALE.UTF8to the environment variables
If the problem persists: create or update a WINEPREFIX using your locale
WINEPREFIX=/path/to/wineprefix/ LANG=your_LOCALE.UTF8 /path/to/wineboot -u(untested)