Skip to content

Commit cfc3054

Browse files
trasnake87claude
andcommitted
Add note about Wayland causing software rendering issues
Expand the troubleshooting documentation to more clearly guide users who are experiencing software rendering (llvmpipe) or graphics performance issues when running under a Wayland session. This adds a cross-reference to the native Wayland option in the graphics section and a practical note about switching to X11 in the Xwayland glitches section. Closes #82 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
1 parent 856d948 commit cfc3054

File tree

1 file changed

+6
-1
lines changed

1 file changed

+6
-1
lines changed

src/troubleshooting/index.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -104,7 +104,7 @@ your hardware.
104104
You may need to reinstall the proprietary drivers if you had installed
105105
them manually before.
106106

107-
Performance can also degrade by [running under Xwayland](#i-am-running-into-glitches-with-xwayland).
107+
Performance can also degrade by [running under Xwayland](#i-am-running-into-glitches-with-xwayland). If you are on a Wayland session and experiencing software rendering or graphical issues, try switching to an X11 session or running the game [natively under Wayland](#run-natively-under-wayland).
108108

109109
### Black screen with Mesa 23.1+
110110

@@ -224,6 +224,11 @@ These issues are beyond the scope of this project and should be reported
224224
upstream. There are two solutions: Fallback to an X11 session, or run the game
225225
natively under Wayland.
226226

227+
> **Note:** If you are experiencing software rendering (llvmpipe) or other
228+
> graphics performance issues under Wayland, switching to an X11 session
229+
> is often the simplest fix. You can do this by selecting "X11" or "Xorg"
230+
> from your display manager's session menu at the login screen.
231+
227232
#### Run natively under Wayland
228233

229234
By default, the binary does not come with native Wayland support.

0 commit comments

Comments
 (0)