Modding:Installing SMAPI on Steam Deck

From Stardew Valley Wiki
Revision as of 18:05, 5 June 2022 by Pathoschild (talk | contribs) (update for Steam Deck)
Jump to navigation Jump to search

Modding:Player Guide/header

This page explains how to install SMAPI (the tool which lets you use mods) on Steam Deck.

See instructions for: AndroidLinuxmacOSWindows.

Install

Before you install SMAPI, you need to know which version of the game you're running: native (Linux version) or Proton (Windows version). If you're not sure, see this video tutorial.

Stardew Valley in native mode

  1. Download the latest version of SMAPI.
  2. Extract the .zip file somewhere (but not in your game folder!).
  3. Run the install on Linux.sh file, and follow the on-screen instructions.
    (If it the installer asks for your game install path, see how to find your game folder.)

To install manually instead, see instructions in the installer's readme.

Stardew Valley in Proton

TODO

Update SMAPI

Just install the new version; the installer will automatically clean up previous versions.

Uninstall

  1. Launch the installer again (see install steps).
  2. When prompted, choose the uninstall option.

Troubleshooting

SMAPI window no longer appears after game update

  1. Run the SMAPI installer again to fix the launcher.

Can't launch game when SMAPI is installed

  1. Open a terminal in your game folder.
  2. Run ./StardewModdingAPI in the terminal to see what the error is:
    • If you see "The library 'libhostpolicy.so' required to execute the application was not found", you have the Linux version of SMAPI with the Proton version of the game. See the instructions for Proton above.
    • If you see a different error, check whether the troubleshooting page has a section for it. If not, see the 'get help' section there.

Other issues

See the troubleshooting page for general troubleshooting.