Modlunky 2 on Steam Deck

Modlunky 2 on Steam Deck

Modlunky runs on the Deck natively and handles launching Spelunky 2 and various mod tools through Proton for you.

Before you start

Install Spelunky 2 and launch it from Steam at least once. Steam only creates the game's Proton prefix the first time you run it, and Modlunky needs that prefix to exist before it can launch anything. If you skip this, Modlunky will tell you it can't find the prefix.

Install Modlunky

1. Long hold the power button and choose Switch to Desktop.
2. Open a browser and go to the Modlunky 2 repository, or search for "modlunky2 GitHub".
3. Click the latest release on the right side of the page.
4. Under Assets, download modlunky2-x86_64.AppImage.
5. Open your Downloads folder, right click the file (LT), open the Permissions tab, and check Execute.
6. Double click the file to start Modlunky.

Keep the file on internal storage. The Execute permission can't be set on an exFAT or FAT formatted SD card, so if you move it there it will stop opening.

Set it up

1. Modlunky asks where Spelunky 2 is installed. Press I'm feeling lucky and it will find it.
2. Install mods from the Mods tab, then press Launch at the bottom.

Playing from Game Mode

Modlunky works in Game Mode too. In Desktop Mode, right click the AppImage, choose Add to Steam, then switch back. It appears under Non-Steam in your library.

Notes

• To install mods straight from spelunky.fyi, add an API token in Settings. Installing from a downloaded zip works without one. Get one from https://spelunky.fyi/accounts/settings/, then paste it into Settings. The Get your token button in Settings may not open a browser on the Deck, so use that address directly if nothing happens.
• Modlunky stores its own settings in ~/.local/share/spelunky.fyi/modlunky2/, separate from the game folder.
• If you previously ran the Windows build under Proton, your old settings do not carry over.

If something goes wrong

• Modlunky won't open at all. Check the Execute permission is still set, and that the file isn't on an exFAT or FAT SD card.
• The level editor renders black. Some drivers hit a WebKitGTK bug. Launch with WEBKIT_DISABLE_DMABUF_RENDERER=1 set, or add it to the launch options as WEBKIT_DISABLE_DMABUF_RENDERER=1 %command% if you added Modlunky to Steam. It costs GPU compositing, so only use it if you hit the problem.
• Modlunky can't find the game. Launch Spelunky 2 from Steam once, then try I'm feeling lucky again.
• The Get your token button does nothing. Open https://spelunky.fyi/accounts/settings/ in a browser yourself and copy the token from there.