Plugins, mods, Looks & cloud saves

Extend RecompLauncher with sandboxed .rlplugin packages, unpack HD texture packs into game folders, enable Windows ReShade Looks, share saves across versions, and launch Big Picture.

1,766 Catalog entries (32 origins)
281,568 GitHub release downloads
Win · Linux · Mac v0.90.0-beta.47 GPL-3.0
8BitDo Ultimate C wireless gamepad controller with dual analog sticks and ABXY buttons on a dark desk
RecompLauncher compiles SDL3 controller input statically so Xbox, DualSense, Switch Pro, and 8BitDo pads navigate Big Picture out of the box.

Sandboxed .rlplugin extensions & mod installers

Documented in upstream docs/PLUGINS.md (minimum launcher 0.90.0-beta.4+): plugins add sidebar pages, per-game tabs, and right-click actions without touching your OS outside declared permissions.

Permission model

  • library.read: reads installed game names, folders, and play time; enables custom tabs on installed game pages (`game_tab`).
  • library.add: prompts the player before registering a new folder in the Library.
  • network: restricts outbound requests strictly to hostnames declared in plugin.json sites via rl.net.fetch.
  • install: downloads and unpacks .zip, .7z, and .rar mod or HD texture archives into a game's mods directory after showing filename, source host, and destination.
  • notify: posts in-launcher completion notices; all plugins can be disabled at once in Settings > Plugins.

Minimal plugin.json structure

Pack plugin.json, index.html, and scripts at the root of a zip archive renamed to .rlplugin, then load /_sdk/rl.js:

{
  "id": "hd-pack-helper",
  "name": "Texture Pack Manager",
  "version": "1.0.0",
  "page": { "title": "Textures", "entry": "index.html" },
  "permissions": ["library.read", "install"],
  "sites": ["github.com", "*.githubusercontent.com"]
}

ReShade Looks, DLSS & FSR 4 setup options

Modernizing classic console recompilations without hand-editing INI files in every game folder.

One-toggle Looks (Windows)

Enable CRT shaders, sharpening, or color presets per game. Diagnostic output is isolated under %APPDATA%\com.recomplauncher.app\looks\<game>\ReShade.log so you can disable Looks immediately if a DX12/Vulkan hook conflicts.

Shared NVIDIA DLSS DLL

Register nvidia.dlss (nvngx_dlss.dll) once in shared setup inputs on RTX hardware so compatible Switch, PS4, and Xbox 360 recomps pick it up automatically during Set Up.

Remembered setup toggles

Added in 0.90 Beta 46: when a recomp developer defines optional setup flags (such as DLSS, FSR 4, or audio backend choices), RecompLauncher remembers your selections across version upgrades.

Save sharing, cloud sync & Big Picture mode

Version-proof local & cloud saves

  • Share Saves Between Versions (`#115`): Carries both single-file and multi-file save directories forward when switching or pinning recomp versions.
  • Runtime save detection: Where It Saves indicates when the launcher detected a game's save path dynamically during gameplay (Beta 45).
  • Optional free cloud saves: Syncs saves between your desktop PC, living-room HTPC, and Steam Deck without requiring an account for offline play (`#166`).

10-foot Big Picture couch interface

  • Launch directly into controller mode via recomplauncher --bigpicture or from the synced Steam Gaming Mode shortcut.
  • Pick which monitor Big Picture opens on (`#50`), toggle 12-hour or 24-hour clock format (`#163`), and track scroll position inside long pages and folder browsers (Beta 47).
  • Discord Rich Presence displays RecompLauncher while browsing and switches to the active recomp title while you play (Beta 47).

Verified gamepads for Big Picture

RecompLauncher compiles SDL3 gamepad support directly into the binary so controllers drive menus, folder browsers, and per-game bindings without external mapper tools. As an Amazon Associate we earn from qualifying purchases.

Plugins, mods & settings FAQ

What is a .rlplugin file in RecompLauncher?

A .rlplugin file is a zipped sandboxed web extension containing plugin.json, HTML, CSS, and JavaScript that talks to RecompLauncher through /_sdk/rl.js. You install it via Settings -> Plugins -> Install From File and approve each requested permission.

Can RecompLauncher unpack .zip, .7z, and .rar mod archives?

Yes. Plugins granted the install permission can invoke rl.install.zip(...) to download and unpack .zip, .7z, and .rar texture packs or mods directly into a game's mods subfolder after explicit user confirmation.

Do I need an account to use RecompLauncher or mods?

No. Every catalog download, local save backup, ReShade Look, Steam sync, and plugin works offline or without signing in. Optional free accounts add cross-device cloud saves and library sync across desktop and handheld PCs.

How do ReShade 'Looks' screen effects work?

On Windows, RecompLauncher's Looks feature applies curated screen effects (CRT scanlines, color grading, anti-aliasing) per game without manual DLL copying, logging output to %APPDATA%\com.recomplauncher.app\looks\<game>\ReShade.log.