How to Fix Minecraft on Steam Deck
Play Minecraft Java on Steam Deck with Prism Launcher from Discover. Install it in Desktop Mode, let it fetch Java, add it to Gaming Mode and set up controls.
Quick Fix
Switch to Desktop, install Prism Launcher from Discover, sign in and let Prism download Java, then add Prism to Steam as a Non-Steam game.
Error Message
Minecraft not launching on Steam Deck / Controller issuesHow to Fix
Open the STEAM menu, choose Power and then Switch to Desktop.
Open Discover from the taskbar, search for Prism Launcher and install it. Discover installs apps as Flatpaks on the writable part of the drive, so SteamOS updates leave them alone.
Start Prism, add your Microsoft account and create an instance for your version. Let Prism download Java when it asks, or turn on automatic Java downloads in its settings.
On the desktop, clicking the right trackpad is a left click, clicking the left trackpad is a right click, and STEAM + X opens the on-screen keyboard.
To play from Gaming Mode, open Steam on the desktop, click Add a Game in the lower left, choose Add a Non-Steam Game and pick Prism Launcher. It then appears in the library under Non-Steam.
For controller support inside the game, add a mod such as Controlify, which has 26.2 builds for Fabric and NeoForge.
Back up ~/.var/app/org.prismlauncher.PrismLauncher/data/PrismLauncher, where the Flatpak version of Prism keeps its instances, worlds and settings.
Common Causes
- The launcher was installed outside Flatpak, for example with pacman. Valve warns that software installed that way may be wiped by the next SteamOS update.
- The Java version is wrong. Minecraft 26.2 needs Java 25, and an older Java can't start it.
- Minecraft Java has no controller support of its own. It only reads keyboard and mouse, so the Deck's buttons need a controller mod or a Steam mapping to work in game.
- Prism can't reach a file. The Flatpak build runs in a sandbox with its own data folder, plus read access to Downloads for dragging in mods.
- The wrong package was installed. Flathub also lists com.mojang.Minecraft, which isn't marked as verified, while Prism Launcher is.
Diagnostic Steps
- Switch to Desktop from the Power menu.
- Install Prism Launcher from Discover.
- Sign in and let Prism download Java.
- Add Prism to Steam as a Non-Steam game.
- Return to Gaming Mode and start it there.
FAQ
Which launcher works best on Steam Deck?
Prism Launcher from Discover. It is verified on Flathub, installs as a Flatpak that SteamOS updates leave alone, and downloads the Java version each instance needs.
Can I play Minecraft in Gaming Mode?
Yes. Add Prism Launcher to Steam as a Non-Steam game from the desktop, return to Gaming Mode and start it from the Non-Steam tab in your library.
Do the Steam Deck controls work in Minecraft?
Minecraft Java has no controller settings, so a mod like Controlify is the way to get real controller support. On the desktop the trackpads work as a mouse and STEAM + X brings up a keyboard.
Related Errors
How to Fix Java Not Found by Launcher
Unable to find Java / No compatible Java installation found
How to Fix MultiMC/Prism Instance Launch Error
Error: Instance X failed to start / Could not set up instance
How to Fix Audio Issues on Linux
Failed to open OpenAL device / Error starting SoundSystem. Turning off sounds & music
