How To Install SMAPI on the Steam Deck (native)

From The Stardew Modding Wiki

So you've managed to get your hands on a Steam Deck, and now you want to play modded Stardew Valley on it, do you? Well you've come to the right place! Read on to figure out how.

Setup[edit | edit source | hide | hide all]

If this is your first time turning on the Steam Deck, go ahead and follow the on-screen instructions to get everything set up.

Once that is done, go ahead and install Stardew Valley from the Library menu.

Step By Step Instructions[edit | edit source | hide]

  1. Turn on your Steam Deck. Wait until it gets to the "normal" screen, which is usually whichever page you last left it on.
  2. Hold down the power button for 3-5 seconds. A small popup menu should show up in the center of the screen with various options. (If you don't hold it down for long enough, the system will simply go to sleep. If you hold it down for too long, the system will force shut down. If either happens, you'll just have to turn it back on and try again.)
  3. Select "Open in Desktop Mode"
  4. The system will restart in "Desktop Mode". Wait until it finishes this process before trying to do anything more.
  5. Open Firefox. There should be a Firefox icon in the taskbar at the bottom of the screen.
  6. Navigate to smapi.io and download the latest version of SMAPI.
  7. Open Dolphin, which is the name of the File Manager program that comes bundled with the Steam Deck. It should be the little folder icon found in the taskbar at the bottom of the screen.
  8. Go to the Downloads folder, where by default your SMAPI installer zip should have downloaded to.
  9. Right click on the SMAPI installer zip file and click Extract > Extract archive here
  10. Open the folder you just created
  11. Right click on the linux installer and select "Run In Konsole"
  12. Follow the on screen instructions to install SMAPI
  13. That's it, you're done!

Play the Game[edit | edit source | hide]

  1. Press the lil icon in the bottom right corner to hide all windows and show the desktop.
  2. There should be an icon on the desktop that says "Return to Gaming Mode." Double click on that and wait for the system to restart.
  3. Once you're back in "Gaming Mode" just select Stardew Valley and click "Play."
  4. You are now playing Stardew Valley on the Steam Deck with mods! Congrats!

Installing Mods[edit | edit source | hide]

There are a few ways you can get the mods you want onto the Steam Deck.

To find out where your Mods folder is...[edit | edit source | hide]

  1. Open Desktop Mode on the Steam Deck
  2. Launch the Steam application, which can be found on the desktop
  3. Click on Library
  4. Right click on Stardew Valley
  5. Select Properties
  6. Select Local Files
  7. Select Browse
  8. Once you're here, right click on the Mods folder and select "Add to Places" to bookmark it on the sidebar.

1. Cloud File Storage[edit | edit source | hide]

This option assumes that you've already been playing modded Stardew Valley on your personal computer.

  1. Install 7zip
  2. Right click on your Mods folder and select 7 zip > add to Mods.zip
  3. Upload Mods.zip to a cloud file hosting service, such as Google Drive
  4. Open said cloud file hosting service on your Steam Deck using Desktop Mode and download Mods.zip
  5. Extract the zip inside your Mods folder

2. Micro SSD[edit | edit source | hide]

This option assumes that you've already been playing modded Stardew Valley on your personal computer. This is probably the easiest option, but requires that you have a properly formatted Micro SSD card.

  1. Insert the Micro SSD card into your computer
  2. Drag your mod folder over into the Micro SSD card
  3. Eject the Micro SSD card
  4. Plug the Micro SSD Card into your Steam Deck
  5. Use Desktop Mode to drag the mods over from the Micro SSD Card into your Mods folder

3. Warpinator[edit | edit source | hide]

This option forms a live wireless connection from your computer to your Steam Deck, using a program called Warpinator.

  1. Install the Windows version of Warpinator, called Winpinator, on your Windows laptop here.
  2. Open Winpinator on your Windows machine once it's finished installing.
  3. Open your Steam Deck in Desktop Mode
  4. Open the Discover program (this is a software management application for Linux)
  5. Type "Warpinator" in the search bar at the top
  6. Click on Warpinator
  7. Click Install
  8. Once installation is complete, launch the application.
  9. The two programs should pair with one another, and allow you to transfer files between the two computers.

A video tutorial on this can be found here.

4. Manual Installation[edit | edit source | hide]

This is the longest and most tedious method.

  1. Enter Desktop Mode on the Steam Deck
  2. Navigate to Nexus Mods or the modding website of your choice and download the mods you want one by one
  3. Extract the mods and drag them into the Mods folder

Troubleshooting[edit | edit source | hide]

A difference in the way that SMAPI runs on Linux (which is what the Steam Deck is running) versus Windows is file case sensitivity. If you get new errors in your game that you didn’t get when you launched the modpack on PC, carefully look through your logs for the offending mods and see if they are looking for a file that is improperly capitalized when it is/isn’t expecting it.

Changing your key bindings[edit | edit source | hide]

… WIP