Junk Store Decky Plugin Troubleshooting

Fix Epic and GOG game issues directly from Game Mode! This comprehensive troubleshooting guide covers Junk Store Decky plugin installation, compatibility problems, and authentication solutions for Steam Deck users.

Showing all solutions

General Plugin Issues

Dependencies aren't installing - how do I fix this?

If you're seeing errors and dependencies aren't installing, try running these commands in Konsole:

Command sequence:

export DECKY_PLUGIN_RUNTIME_DIR=~/homebrew/data/Junk Store
export PYTHONPATH=~/homebrew/plugins/Junk Store/scripts:$PYTHONPATH:~/homebrew/plugins/Junk Store/scripts/shared
export DECKY_PLUGIN_DIR=~/homebrew/plugins/Junk Store
export DECKY_PLUGIN_LOG_DIR=~/homebrew/logs/Junk Store
cd ~/homebrew/plugins/Junk Store
./scripts/install_deps.sh

What this does: Sets up the correct environment and runs the dependency installer manually.

When I launch a game, Steam tries to download something but it gets stuck at 0%

This is a known Steam issue, often related to Proton 9. We recommend switching to a GE-Proton version instead, as these are better suited for running non-Steam games. Open the game's properties in Steam and select a different Proton version from the Compatibility tab to resolve the issue.

Games aren't showing up in the Non-Steam tab

Check your settings and make sure the shortcut isn't hidden. After changing settings, reboot your Steam Deck for changes to take effect.

Shortcuts aren't appearing

Try rebooting your device first. If they still don't appear, ask for help in the plugin-support forum on Discord.

I don't have Proton GE or don't know how to install it

To get Proton GE or other custom versions of Proton, you can use one of the following tools:

ProtonUp-QT — A simple app that lets you download and manage Proton versions. You can find it in the Discover Store (in Desktop Mode).
Wine Cellar — A Decky plugin that works similarly to ProtonUp-QT. If you already have Decky installed for other plugins, you can install Wine Cellar directly from the Decky Plugin Store.

Once installed, use either tool to download the latest GE-Proton release. After that, you'll be able to select it as a compatibility option in Junk Store.

Please refer to our Tutorials page to see how to change/check your Proton version if you are unsure how to do this.

Having issues bringing up the keyboard in Game Mode?

If the Steam + X shortcut isn't bringing up the keyboard try the following:

Try to bring up the keyboard ⌨️ from the Quick Access Menu (⋯).
Tap directly on a text field (like a password box) to prompt the keyboard.
Try toggling to Desktop Mode and back to Game Mode to reset input services.
Restart Steam or the device if the issue persists.

This is a known Steam bug that has been around for a while. These steps usually help work around it until Valve fixes it in a future update.

Epic Games Troubleshooting

Experiencing Epic Games login issues?

Legendary sometimes has trouble logging in, especially with alternative authentication methods. Try these solutions:

Method 1 - Big Picture Mode Login:

Switch to Desktop Mode
Launch Steam in Big Picture mode
Try logging in there
Once successful, return to Gaming Mode

Method 2 - "Unable to complete login" error:
If you get this error, use the command-line workaround:

Switch to Desktop Mode and open Konsole
Run: flatpak run com.github.derrod.legendary auth --disable-webview
It will launch a browser for you to log in
Copy the provided code and paste it back into Konsole

Legendary ERROR pop-up when signing in?

If you see "Legendary status produced no output," your credentials may be corrupted.

In Desktop Mode, open Konsole and run:
/bin/flatpak run com.github.derrod.legendary auth --delete
Then re-authenticate with:
/bin/flatpak run com.github.derrod.legendary auth

Have you recently changed your Epic password?

If you've changed your password and are having issues logging in, simply reboot your Steam Deck.

How do I update the Legendary Flatpak?

Go to About > Dependencies in the Junk Store UI and click "Install Dependencies" again.

Can't verify captcha — mouse won't reach button?

Try the following:

Use a keyboard and press Tab to cycle to the Verify button.
In Game Mode, change the resolution to 3840x2160 via:
Epic Games Login > Properties > Shortcut > Game Resolution.
Or run in Konsole:
flatpak run com.github.derrod.legendary auth --disable-webview

I don't see any games in my Epic library.

Check the following:

If you have more than one Epic account, make sure you are logged into the correct one.
Press X to toggle the "Show Installed" filter — it may be hiding your uninstalled games.
Clear the search bar at the top — any text here will filter your library.
Refresh your games list from the main Epic tab:
Sliders menu > Refresh Games List
Reboot the Steam Deck
Log out and log back into your Epic account

Games won't load — Microsoft Visual C++ error?

If prompted to install Microsoft Visual C++ Runtime:

Download the X64 redistributable from Microsoft Learn.
Copy the file to the game's install folder:
~/Games/epic/[game title]
In Junk Store, go to the game's slider menu → Run EXE in Game Folder
Select VC_redist.x64.exe and complete the install.

This should allow the game to run.

Junk Store and EGS library don't match?

Have you tried refreshing your games list?

Refresh your games list from the main Epic tab:

Sliders menu > Refresh Games List

Or run the following in Konsole to refresh:

flatpak run com.github.derrod.legendary list --force-refresh

If missing games still don't appear, they may require a third-party launcher and are currently unsupported.

Game won't download — CRITICAL error?

If you get:
CRITICAL: installation cannot proceed, exiting
It likely means your storage is full. Free up space or install to another location.

Installing games to SD card causes a Permissions Error?

Possible causes:

Your SD card may not be formatted correctly.
Old dependencies — revisit About > Dependencies and reinstall them.
SD card naming: If you've renamed your SD card, it may not be in the path Junk Store expects (/run/media/mmcblk0p1). See solution below.

Bazzite users:
If you are getting this error you need to edit the settings.sh file to match your setup.

The file you need to edit is here:
~/homebrew/plugins/Junk-Store/scripts/Extensions/Epic/settings.sh

Look for the line:
INSTALL_DIR="/run/media/mmcblk0p1/Games/epic/"

That's the fallback path Junk Store expects. If your SD card has a different name or path, update this line to match your actual SD card location.

GOG Extension Troubleshooting

GOG Extension installer won't execute or opens in text editor

Problem: When double-clicking the GOG Extension installer, nothing happens or it opens in Kate text editor.

Solution:

Check file permissions: Right-click → Properties → Permissions → Check "Is executable"
Check for theme conflicts: Custom icon packs can break system dialogs. Switch to default theme temporarily
Use console as backup: Right-click → "Run in Konsole" to see error messages

Most common cause: Custom icon themes interfering with system dialogs (zenity).

I can't get GOG to run in Junk Store.

Make sure you're using the latest version of Junk Store from the Decky Testing Store.

You'll also need to reinstall dependencies by going to the About section and clicking "Install Dependencies."

Once you've purchased the GOG extension, please follow the GOG Extension Install Guide to install the extension and link it to your Junk Store plugin.

I don't see any games in my Gog library.

Check the following:

If you have more than one Gog account, make sure you are logged into the correct one.
Press X to toggle the "Show Installed" filter — it may be hiding your uninstalled games.
Clear the search bar at the top — any text here will filter your library.
Refresh your games list from the main Gog tab:
Sliders menu > Refresh Games List
Reboot the Steam Deck
Log out and log back into your Gog account

Game Compatibility Problems

My game works in Heroic or Lutris, but not in Junk Store

Games that run in Heroic or Lutris usually work in Junk Store too — it's just a matter of finding the right tweaks:

Check our game compatibility table first — see if the game is listed in our tested games database for known compatibility status and specific tweaks.
Try switching to a different GE-Proton version.
Install any required or missing dependencies (you may sometimes get a prompt to install a Microsoft C++ runtime, or something else).
Some Epic games require the EOS overlay to be enabled before they will work. Make sure you have installed this globally (Epic tab) and enabled it for the game (done from the game page in Junk Store).

Please refer to our Tutorials section to learn how to change or check your Proton version or install Microsoft C++ runtimes if you are unsure how to do this.

If that doesn't work, ask for help in our Discord server. Please be patient—our team is small! While we have a decent game library, we don't have every game, so we may only be able to offer advice rather than fixes.

Game launches but controller doesn't work?

Try the following:

Restart your Steam Deck — this can resolve odd controller issues.
Check your Steam Input settings — they may be interfering.
Open and close the Quick Access menu — this can "wake" controller detection.
Change the Proton version — ProtonGE is often more compatible.

If none of these work, further research may be needed. Note that we can't test every game.

Why won't my game launch?

Games may fail to launch for a variety of reasons. Here are some common causes and what you can do:

Wrong compatibility layer:
Try switching to a different version of Proton. Non-Steam games usually work best with GE-Proton. We recommend finding a version that works well for most of your library and using it as the default for non-Steam games.

However, some titles require a specific version of Proton or GE-Proton to run properly.
Missing dependencies:
Some games require additional libraries such as Microsoft C++ Runtime or DirectX. These dependencies may not always trigger an obvious error message, so try installing them if you suspect they're missing.
Check compatibility resources:
📋 First check our Games Tested table for compatibility status and any specific workarounds for your game.

If not listed there, visit ProtonDB.com for community tips. You may find game-specific tweaks, compatibility reports, or Proton version recommendations that solve your issue.

Advanced Troubleshooting

What are the backend scripts, and do I need them?

These are optional example scripts mainly for DOSBox games. They are not officially supported and may stop working if Junk Store is updated. Use them only if you know how they work.

How do I uninstall the backend scripts for DOS and Win 3.1?

You can delete them manually from:
~/homebrew/data/Junk Store/scripts/Extensions

Game gets stuck at the Steam pre-launch screen

This might be caused by another plugin (like decky-cloud-save) locking Junk Store's files.

Make sure nothing is interfering with this folder:
/home/deck/homebrew/data/Junk Store

Junk Store relies on that data directory to function correctly.