eugeniosegala/decky-lsfg-vk-experimental v0.13.0-experimental.24

Decky LSFG-VK Experimental 0.13.0-experimental.24

on GitHub

Optional coexistence: If you want to keep the original/public Decky LSFG-VK plugin installed, you can. Both plugins can remain installed and enabled. For native Steam/Proton games, choose exactly one launch wrapper: public ~/lsfg %command% or experimental ~/.local/bin/lsfg-vk-experimental %command%; never combine them. Flatpak apps, including Heroic, are selected through Flatpak setup instead.

What’s new since experimental.21

• Engine update: Bundles checksum-verified lsfg-vk 2.0.0-dev28-experimental.24. Complete the required in-plugin engine-update step after installing the ZIP.
• Stronger Adaptive recovery: After a Steam-menu or focus interruption, Adaptive preserves the recovered real-frame baseline while restoring the previous generation level. If that level causes a sustained throughput collapse, it confirms the result with one second of real-only frames and returns to the lower proven level.
• Safer generated-image recovery: A single generated-image acquisition recovery now stays in place and refreshes three history frames. Only a repeated recovery within 15 seconds may request guarded swapchain recreation, with a five-second cross-context cooldown.
• Maximum multiplier protection: Smooth Cadence restoration, rescue, and recovery respect the selected Maximum Adaptive Multiplier.
• Live configuration: Frame Generation, Adaptive Target, Maximum Adaptive Multiplier, Smooth Cadence, Flow Scale, and Performance Mode apply without a restart. Switching between Fixed and Adaptive, or increasing a Fixed multiplier beyond the capacity used when the game created its swapchain, requires a game restart.
• Live Frame Generation control: Turn synthesis off or on immediately without changing the selected Fixed or Adaptive settings.

See the Configuration guide and Troubleshooting guide for the full behaviour and per-game controls.

⚠️ Required engine-update step: Installing the ZIP updates the plugin files, but does not by itself replace the private LSFG-VK layer. Open this plugin and select Install Experimental LSFG-VK (developer build) to install the version bundled in the new ZIP.

First-time Heroic setup: Read the Heroic and other Flatpak applications guide in the README.

Installation

New to Decky or installing this plugin for the first time? See the full Install and use guide for Decky Loader setup and prerequisites.

1. Download Decky.LSFG-VK.Experimental-0.13.0-experimental.24.zip below.
2. On the Steam OS, open Decky Loader's settings and enable Developer Mode.
3. Choose Developer > Install Plugin from Zip, then select the downloaded ZIP.
4. In the plugin, select Install Experimental LSFG-VK (developer build). For native Steam/Proton games, add ~/.local/bin/lsfg-vk-experimental %command% to the game’s Steam launch options.

Updating an existing experimental installation

1. Quit any game currently using ~/.local/bin/lsfg-vk-experimental.
2. Download the newer ZIP from this fork’s releases.
3. In Game Mode, open Decky Loader’s settings, then choose Developer > Install Plugin from Zip and select it.
4. Reload the plugin from Decky. If it does not reload automatically, restart your Steam Deck or Steam Machine.
5. ⚠️ Required: Open this plugin and select Install Experimental LSFG-VK (developer build) to install the version bundled in the new ZIP. Installing the ZIP updates the plugin files, but does not by itself replace the private LSFG-VK layer. Do not skip this step.
6. If you use Heroic, select Flatpak Setup, then select Update for Heroic’s matching runtime extension (usually 25.08). This replaces its Flatpak layer with the engine bundled in the new ZIP; Heroic preparation and per-game Wrapper commands remain unchanged.
7. If Decky does not show or reload the update, use the reinstall-and-restart fallback above, then repeat step 5.

Existing experimental profiles, Steam launch options, and Heroic per-game Wrapper command settings are retained. The engine files are deliberately replaced, not stacked. Prepare Heroic again only after changing the configured Lossless.dll location or disabling its Flatpak preparation. The public/original plugin may remain installed, but use exactly one plugin wrapper per game.

Known limitations of lsfg-vk 2.0.0-dev28-experimental.24

• HDR: HDR remains problematic with this payload. Disable HDR in the game before playing; it can remain enabled in SteamOS. The plugin has no general HDR control, and the v1 HDR toggle was also non-functional.

• No fixed 0x multiplier: Unlike v1, the fixed selector remains 2x, 3x, or 4x. Use the live Frame Generation switch to stop or resume generation without changing its settings. Disable LSFG-VK on Next Launch is separate: it disables the entire layer and requires a game restart. Adaptive mode may internally schedule zero generated frames for an individual interval; that is not a persistent disable setting.

• Isolation trade-offs: The public and experimental plugins can coexist, but a game launched with the experimental wrapper cannot use vkBasalt or other globally installed Vulkan layers, such as overlay or post-processing layers. This affects only that game. If it needs those layers, switch its launch option back to the public plugin’s ~/lsfg %command% wrapper.

Before you play

• This is experimental: test each game before relying on it.
• Confirm the detected Lossless.dll path before launching. Leaving it blank permits upstream discovery.

Engine payload

• Bundles checksum-verified lsfg-vk-2.0.0-dev28-experimental.24-linux.tar.xz.