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

Decky LSFG-VK Experimental 0.13.0-experimental.21

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.

This release: deterministic Adaptive stability baseline

• Engine update: Bundles checksum-verified lsfg-vk 2.0.0-dev28-experimental.21. Complete the required in-plugin engine-update step after installing the ZIP.
• Deterministic Adaptive controller: Adaptive policy now runs through an independently testable, clock-driven state machine with deterministic timing tests and a 120-case compatibility matrix.
• Smooth Cadence ceiling guard: Restoration, rescue, and recovery can no longer retain more generated frames than the selected Maximum Adaptive Multiplier.
• Clearer mode-switch guidance: Adaptive settings continue to apply live, while the UI now explains that switching between Fixed and Adaptive requires a game restart so the game-owned swapchain has the correct capacity.
• Live Frame Generation control retained: 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.21.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.21

• 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.

• 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.21-linux.tar.xz.