mirror of
https://github.com/an-anime-team/an-anime-game-launcher.git
synced 2025-02-13 19:39:47 +03:00
Created Troubleshoot Game (markdown)
parent
531f4d11ea
commit
2650b9cca5
1 changed files with 263 additions and 0 deletions
263
Troubleshoot-Game.md
Normal file
263
Troubleshoot-Game.md
Normal file
|
@ -0,0 +1,263 @@
|
|||
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"](https://docs.google.com/spreadsheets/d/1I3aaXaNbHm-igAsFwvlCEHr5xyQKO4Wot8TuywsOhxw/htmlview#)
|
||||
|
||||
* 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](https://vulkan.gpuinfo.org/), [Intel](https://www.intel.com/content/www/us/en/support/articles/000005524/graphics.html), [nVIDIA](https://developer.nvidia.com/vulkan-driver), [AMD](https://www.amd.com/en/technologies/vulkan#paragraph-218601)
|
||||
|
||||
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](https://docs.mesa3d.org/relnotes.html) 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`](FAQ.md) after launch
|
||||
2. Install proper Vulkan packages:
|
||||
* Check tutorials, such as [LinuxConfig](https://linuxconfig.org/install-and-test-vulkan-on-linux) or [Arch Wiki](https://wiki.archlinux.org/title/Vulkan#Installation)
|
||||
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:
|
||||
|
||||
* Workaround: Disable the window move & resize feature
|
||||
* See [Linux Mint forums](https://forums.linuxmint.com/viewtopic.php?t=264172)
|
||||
|
||||
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`](https://wiki.archlinux.org/title/PRIME#PRIME_render_offload)
|
||||
* ^ If `pvkrun` does not work, uninstall [`bumblebee`](https://wiki.archlinux.org/title/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
|
||||
|
||||
* Ensure that `faudio` is installed (Ubuntu: `libfaudio0`)
|
||||
* See also: [official Wine setup instructions](https://wiki.winehq.org/Download)
|
||||
* Try another, newer Wine version
|
||||
|
||||
|
||||
#### "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)
|
||||
3. 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".
|
Loading…
Add table
Reference in a new issue