Releases: RedRanger14/decky-nexus
Release list
v1.4.1: Store header fits the Deck
The store header fits the screen it is actually on
The row across the top of the Store page (game art, title, search, sort, filter) ran off the right-hand edge on a Steam Deck. The filter dropdown sat partly off screen, and moving the controller onto it made Steam pan the whole page sideways, pushing the tabs off the left. On a handheld that made the Store page feel broken.
It now measures the space it actually has and lays itself out to fit, the same way the mod rails have since 1.2.2. Large screens keep exactly the layout they had. Narrower ones shrink the search box, narrow the dropdowns, shorten a long game name, and finally drop the game artwork, in that order. The controls keep their words at every size, because an earlier attempt at replacing them with icon squares made them harder to understand, not easier.
The fit is now checked automatically at every screen width from 560 to 1920 pixels, so a layout that would run off the edge fails the build rather than shipping.
If v1.4.0 would not install for you
That was our fault and it is fixed. The v1.4.0 download was packaged wrongly, so the installer refused it and installing from the zip failed silently. The v1.4.0 download has since been rebuilt and replaced, and 1.4.1 is built correctly too. Just run the usual install line and it will work:
curl -L https://raw.githubusercontent.com/RedRanger14/decky-nexus/main/install.sh | shYour API key, settings and installed mods live outside the plugin folder and are never touched by an update.
The release process now refuses to publish a plugin package that cannot install, rather than relying on anyone remembering to check.
v1.4.0: Palworld
Palworld, the thirteenth game
Palworld moves from the roadmap to supported. As always, that means installed, modded and played on real hardware, not that the code has a config entry for it.
Palworld mods come in four different shapes, and each one needs to land somewhere different or it silently does nothing. The plugin now routes all four: pak mods, UE4SS Lua scripts, UE4SS Blueprint mods, and PalSchema's JSON mods, which are folders of json that sit inert anywhere except the framework's own mods directory. Step 1 in the panel installs UE4SS and PalSchema together, so there is nothing to set up by hand.
Getting there took two 100-mod collections, and both found real problems.
Mods that offer alternatives now ask which you want. Some mods ship one archive containing several mutually exclusive versions of the same thing, and a wizard to pick between them. That wizard only ran for Skyrim-style games, so on Palworld every version installed at once: eight variants of a single character fighting over the same assets, which rendered as a mangled blend of all of them. Now the wizard runs for these games too, and when you install a collection the curator's own choices answer it for you.
Mods that would ruin your session install switched off. Two kinds, both found the hard way. One opens a setup window the first time it loads that takes no input at all in Gaming Mode, not from a controller, a keyboard or a mouse, so it cannot be closed and you are locked out of your own game. The other rewrites how characters look on top of every other mod, so in a collection full of character mods everything renders as a broken mix of the two. Both are still installed, so nothing is lost, but the collection page says which mods were left off and why, and My Mods switches them back on with one tap.
Also in this release
- Script extenders now match your installed game version rather than assuming the newest, and say so plainly when no build exists for the version you are on.
- Mod pages prefer the file that matches your game, and mods split across several required files install whole.
- Games installed on an SD card or a second drive are found.
- The adult content gate follows your Nexus account settings instead of demanding UK age verification from everyone.
Thirteen games supported: Cyberpunk 2077, Elden Ring, Fallout 4, Fallout: New Vegas, Helldivers 2, Mount & Blade II: Bannerlord, Palworld, Resident Evil 4, Skyrim Special Edition, Slay the Spire 2, STAR WARS Battlefront II, Stardew Valley, The Witcher 3.
v1.3.0
Script extenders now install the build that matches your game. If you deliberately downgraded Skyrim or Fallout 4, Step 1 installs the SKSE or F4SE built for your exact game version instead of the newest one, read from the game's own executable.
Script extenders now appear in the Updates tab. They never did before - the mod everything else depends on was the one thing the plugin never checked. It also tells you when your game needs an older build than you have, which is the normal case after a downgrade.
And when no build exists for your game at all, it says so. Bethesda's 27 August Skyrim patch (1.7.104) is newer than any published SKSE, so mods cannot load on it yet. The plugin now tells you that plainly rather than leaving you to discover it from the game's own error box.
Mods with per-version files pick the right one. Where a mod publishes separate files per game version - Engine Fixes, Address Library and friends - the file naming your version is now the default, and the mod page says "Chosen to match your game".
Mods split across several files install whole. SSE Engine Fixes ships its plugin and its preloader as two separate downloads that install to different places; only installing the first left the game refusing to start. Both now come together, and the preloader is correctly skipped on game versions where its author retired it.
FOMOD installers stop offering coin flips. When an installer declares which option suits which game version, that option is now preselected and labelled "matches your game (1.6.1170)", with the others marked for the versions they target. Engine Fixes' wizard offered an "Anniversary Edition" and a "Special Edition" dll as equal choices, and picking the wrong one killed the game at launch.
Also: Skyrim's ContentCatalog repair now runs when the game panel opens rather than only from the Health page, and Baldur's Gate 3 joins the requested games list.
v1.2.3
Script extenders now match your game's version. If you deliberately downgraded Skyrim (or Fallout 4) to protect your mod list, Step 1 now installs the SKSE or F4SE build made for the exact game binary you have, read from the game's own exe, instead of the newest build that only works on the latest patch. The toast tells you which build it picked. (Thanks to everyone who reported this.)
Adult content now works outside the UK. Age verification is a UK legal requirement and the verification flow only exists there, but the plugin was demanding it from every country. It now works the way the website does: your account's adult content preference is enough everywhere, and verification is additionally required only where the law says so. Nothing changes for UK users. (Thanks to the reporter from the Netherlands.)
v1.2.2
Games on SD cards and second drives are now found. The plugin searches every Steam library, not just the internal one, and reads each game's Proton prefix from the library that actually holds it. If your game showed "not found" because it lives on a microSD card, this release is the fix. (Thanks to the player who reported Witcher 3 on a microSD.)
Battlefront II mods that replace character models now render correctly. Three bugs in our mod compiler were found by comparing its output byte-for-byte against Frosty's on the same mod, and all three are fixed in compiler build 2. The plugin upgrades your installed compiler automatically the next time you install or toggle a mod. Battle Damaged Darth Vader, The Mandalorian and friends now look like they should instead of a mass of shards.
Multi-part Battlefront II mods install whole. Mods that ship as a set (The Mandalorian's base, text and weapon parts) install together without asking; mods that offer alternatives show a readable choice (Cracked / Full Helm / NOHelmet) instead of three near-identical file paths, with an "install all parts" option where that makes sense.
Mods that can never work on Deck are labelled. Desktop-app plugins like BetterSabers now carry a DESKTOP APP ONLY badge on their tile and an explanation on the mod page, before you download anything.
Store rows fit your screen. Mod rails now fill the width on any display, with the View all tile always visible as the last card, on Deck and on TV alike.
Also: installs, toggles and removals narrate what they are doing with live progress; a mod built for a different game version says so on its page and in My Mods; and background rebuilds no longer show up as phantom downloads.
Frosty toolkit build 2
Second build of the Battlefront II mod compiler (FrostyCli, linux-x64), used by the plugin's Step 1. Changes from build 1, all found chasing replaced character models rendering as shattered geometry:
- The manifest's streaming-chunk entries now cover the full written blob rather than the firstMip sub-range, matching the vanilla game and Frosty v1. Sub-ranged entries made every replaced mesh stream a fragment of itself.
- ShaderBlockDepot merge handler ported from Frosty v1 (hash 0x89EF2205). Mesh mods ship shader-block deltas that must be merged into the game's depot; with no handler they were silently skipped, leaving the game's original shader blocks describing a mesh that was no longer there.
- Handler output is exempt from the base-data copy skip, so merged resources actually reach the cas archives.
- ZSTD_compress P/Invoke binding gained its missing fifth argument (compression level); it was passing register garbage before.
Verified against real Frosty v1 output for the same mod: every res and chunk in the touched bundles is byte-identical decompressed (27 res including both merged shader depots), and the full read-back validation passes: res ok=84130 bad=0, chunks ok=211705 bad=0.
Frosty toolkit (linux-x64)
FrostyCli built for linux-x64, with the pieces needed to apply Star Wars
Battlefront II (2017) mods on SteamOS.
Contents: FrostyCli (self-contained .NET 8), the game profiles, a pre-generated
type SDK for Battlefront II (so the game does not need to be running and no
ptrace access is needed), and the third-party libraries including CryptBase.dll.
Built from FrostyToolsuite master (ee2a587) plus the patch in
docs/frosty-swbf2/frostycli-swbf2.patch, which implements the SuperBundleManifest
bundle format and fixes four data-corruption bugs. See docs/frosty-swbf2/WORKING.md.
This is a tool bundle, not a plugin release. The plugin downloads it on demand.
v1.0.0
v1.0.0 (beta)
The first numbered release. Unofficial, in beta, and Premium-only: free
accounts can browse but the Nexus API does not give them download links.
What it is
Browse, download, install, update and manage Nexus Mods content from Gaming
Mode with a controller, on SteamOS and Bazzite. No Desktop Mode after
install.
Built with AI (Claude), directed and tested by hand: every supported game
below was installed, modded and played on real hardware before it shipped.
Supported games
Cyberpunk 2077, Elden Ring, Fallout 4, Fallout: New Vegas, Helldivers 2,
Mount & Blade II: Bannerlord, Resident Evil 4, Skyrim Special Edition,
Slay the Spire 2, Stardew Valley, The Witcher 3.
Helldivers 2 note: the game changes its data files with every update, which
breaks most mods until their authors re-release. The plugin flags stale mods
with a PRE-UPDATE badge and can filter to mods updated since the game's last
patch. Every mod manager lives with this on that game.
Highlights since the last build you may have tried
- One-tap updates, with the version picker opening inline when an update
offers choices - Filters next to sort: the game's categories, recently updated, and "since
game update" on live-service games - Bannerlord: full support - frameworks installed and activated, load order
solved from the mods' own declared rules, collections gated honestly by
the game version they target - ReShade packages install where configured, launch options set
automatically, with the injection risk stated before the download - Collections skip what cannot work on your game version and name every
skip, rather than crashing you at boot
Installing
One line in Desktop Mode's Konsole - the README walks through every step,
including where your API key lives:
curl -L https://raw.githubusercontent.com/RedRanger14/decky-nexus/main/install.sh | sh
Updating is the same line. Mods, settings and your key survive updates.
Known limitations
- Premium only (API limitation, stated up front)
- No manual load order editing yet
- Decky's own "Install from URL" is broken (Decky bug); use the script or
"Install from zip" - Updates to the plugin are manual until a store exists
Report problems via GitHub Issues - the plugin's Health page can package the
details for you.
v0.263.0
Unofficial Nexus Mods plugin for Decky Loader: browse, install and manage mods
for the game you are playing, from Gaming Mode on a controller.
What changed in this build
- Updating no longer asks for your API key again. If a key is already saved,
the installer says so and leaves it alone. A first install still asks. - Report a problem now produces a link GitHub can open even when you have to
sign in on the way. The plugin log is no longer pasted into the link, which
is what made it too long; the report names the log folder instead so you can
attach it if you want to.
What it needs
A Nexus Mods Premium account. Free accounts can browse but cannot download,
because Nexus only offers free downloads through a browser.
Supported games
Cyberpunk 2077, Elden Ring, Fallout 4, Fallout: New Vegas, Resident Evil 4,
Skyrim Special Edition, Slay the Spire 2, Stardew Valley, The Witcher 3.
Install
See the README. One command in Desktop Mode, then everything else is on the
controller. Already installed? Run the same command again to update.
This is a beta and it changes game files. Every supported game can be put back
to vanilla from inside the plugin, but back up saves you care about first.
Not affiliated with or endorsed by Nexus Mods.
v0.262.0
Unofficial Nexus Mods plugin for Decky Loader: browse, install and manage mods
for the game you are playing, from Gaming Mode on a controller.
What changed in this build
- Report a problem now produces a link GitHub will actually open. The report
body was capped at 5500 characters, but percent-encoding roughly triples
that, so the finished URL was too long and GitHub answered with its own
error page. The body is now measured after encoding, and the log tail is
trimmed first so the setup summary always survives.
What it needs
A Nexus Mods Premium account. Free accounts can browse but cannot download,
because Nexus only offers free downloads through a browser.
Supported games
Cyberpunk 2077, Elden Ring, Fallout 4, Fallout: New Vegas, Resident Evil 4,
Skyrim Special Edition, Slay the Spire 2, Stardew Valley, The Witcher 3.
Install
See the README. One command in Desktop Mode, then everything else is on the
controller. Already installed? Run the same command again to update.
This is a beta and it changes game files. Every supported game can be put back
to vanilla from inside the plugin, but back up saves you care about first.
Not affiliated with or endorsed by Nexus Mods.