This page lists common quirks and known issues with various games and setups. If you're encountering problems with lsfg-vk, try applying any of the suggestions. These solutions have been found by the community and often resolve common issues.

Try these general suggestions first, as they can often fix a variety of problems:

• VSync: Explicitly enable VSync in the game's graphics settings and avoid overriding the present mode using lsfg-vk.

• Framerate: Set a framerate limit ingame or using DXVK_FRAME_RATE.

• VRR: Disable Variable Refresh Rate as it is currently not supported.

• Other Vulkan Layers: Disable other installed Vulkan layers like MangoHud, VkBasalt.

If you are using a Wayland compositor, these tips might help resolve issues:

• Tearing: Disable tearing control in your Wayland compositor (this setting is often labeled as "enable no-tearing").

• Direct Passthrough: Disable any "direct passthrough" or "bypass compositor" options, especially for fullscreen applications.

• Windowed Mode: Try running the game in a window instead of fullscreen.

lsfg-vk is a Vulkan layer, so it doesn't work directly with OpenGL games. You can, however, try to run them through Zink, a Vulkan-based implementation of OpenGL:

• Enable Zink: Use the following environment variables to run your game with Zink:

__GLX_VENDOR_LIBRARY_NAME=mesa MESA_LOADER_DRIVER_OVERRIDE=zink GALLIUM_DRIVER=zink

• Zink Crashes: If your game crashes or freezes when using Zink, unfortunately, lsfg-vk might not be compatible with that specific game at this time.

Here are some tips specific to the Steam Deck environment:

• Gamescope: Try launching the game with the gamescope Vulkan layer disabled using the following launch option. This will make some compositor options non-functional:

ENABLE_GAMESCOPE_WSI=0 %command%

• Resolution and Scaling: Lower the game's resolution and use non-linear scaling, which can be found in the debug menu.

• Future Updates: Please wait for the official release of lsfg-vk version 1.1.0, which is expected to include more robust support for the Steam Deck.

• Proton: When using Proton to run a 32-bit Windows game, try adding PROTON_USE_WOW64=1 to the launch options. This may not work with older Proton versions.

• Native Games: Frame generation does not currently work for native 32-bit Linux games.

There's not much you can do about this, except wait for future updates to lsfg-vk and the performance overlays in question.

If you've tried the suggestions above and are still encountering problems, please help us by submitting a detailed bug report. Visit the How to Ask for Help guide to learn how to gather the necessary information and submit a clear report.