Skip to content

Commit

Permalink
Mouse/Cursor warp section cleanup
Browse files Browse the repository at this point in the history
put all the gamescope instructions under one heading
  • Loading branch information
mactan-sc authored Dec 30, 2024
1 parent 4a6ed01 commit d5c6f4e
Showing 1 changed file with 9 additions and 11 deletions.
20 changes: 9 additions & 11 deletions wiki/Troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -213,17 +213,15 @@ If this page doesn't help resolve your issue, you may ask for help on our [socia
## 🤪 Unexpected Behavior (sometimes also crashes)

#### Mouse/Cursor warp issues and view snapping in interaction mode
- The 3.18 update caused mouse and view snapping issues for most Penguins using Wayland + some desktop environments, especially KDE. The simplest workaround is to use Xorg or switch to an alternate desktop environment. For example, most Gnome users don't seem to experience this issue.
- Wine version >=9.20 helps mitigate this for some.
- kwin >=6.2.2 helps mitigate this for some.
- Alternatively, build xwayland with this [patch](https://github.com/Nobara-Project/rpm-sources/blob/main/baseos/xorg-x11-server-Xwayland/xwayland-pointer-warp-fix.patch) applied.
- If using KDE and patching xwayland, you will also need to install Gamescope and use the `--force-grab-cursor` option.
- **Note for Nvidia users:** Gamescope may not work on your hardware. See this [known issue report](https://github.com/ValveSoftware/gamescope/issues/526).
- A possible fix to get Gamescope working on Nvidia: `Right click the game->Configure->System options->Game execution->Environment variables` then find or create `__GL_THREADED_OPTIMIZATIONS` in the left column and change/set it to `0` in the right column.
- After installing Gamescope, enable it in Lutris: `Right click the game->Configure->System options->Gamescope->Enable Gamescope`. Then, set `Output Resolution` to your monitor's native resolution, ie `1920x1080`.
- If you're using a version of gamescope newer than **3.11.51**, an additional Gamescope setting is required. Set `Relative Mouse Mode` to on
- Other Gamescope settings that may be required depending on your system: `Window Mode` set to `Fullscreen` if it doesn't launch fullscreen, `-g` in `Custom Settings` to grab keyboard
- Depending on your system, `Prefer System Libraries` may need to be enabled or disabled in Lutris
- Mouse and view snapping issues for most Penguins using Wayland + KDE and other desktop environments. The simplest workaround is to use Xorg or switch to an alternate desktop environment. Most Gnome users don't seem to experience this issue
- Wine version >=9.20 helps mitigate this for some
- kwin >=6.2.2 helps mitigate this for some
- Gamescope helps mitigate this for some
- **Note for Nvidia users:** Gamescope may not work on your hardware. See this [known issue report](https://github.com/ValveSoftware/gamescope/issues/526). A possible fix to get Gamescope working on Nvidia is to set environment variable `__GL_THREADED_OPTIMIZATIONS=0`
- Install and enable gamescope. set these options to for your display resolution `-W 2560 -H 1440 --force-grab-cursor`
- Other Gamescope settings that may be required depending on your system: `Window Mode` set to `Fullscreen` if it doesn't launch fullscreen, `-g` in `Custom Settings` to grab keyboard
- Depending on your system, `Prefer System Libraries` may need to be enabled or disabled in Lutris
- Alternatively, build xwayland with this [patch](https://github.com/Nobara-Project/rpm-sources/blob/main/baseos/xorg-x11-server-Xwayland/xwayland-pointer-warp-fix.patch) applied. If using KDE and patching xwayland, you will also need to install Gamescope and use the `--force-grab-cursor` option
- If this doesn't work, you will need to switch to Xorg instead of Wayland.


Expand Down

0 comments on commit d5c6f4e

Please sign in to comment.