PDF download Download Article
An in-depth look at how to install mods onto your computer or Steam Deck
PDF download Download Article

Want to take your Stardew Valley game to the next level? Tons of creators have developed countless mods to add new features, practical functions, cute updates, and everything in between to this beloved RPG game. We’ll walk you through how to set up mods on a variety of operating systems, so you can take your Stardew experience to the next level.

Disclaimer: Modding is currently available for Windows, Mac, Linux, and Steam Deck devices, and is completely unavailable for iOS, Nintendo Switch, Xbox, and PlayStation devices. While there is a modding program for Android that’s in its Alpha release , most of these mods are currently dysfunctional.

Things You Should Know

  • Download SMAPI to mod all versions of Stardew Valley (Windows, Mac, Linux, Steam Deck).
  • Download the mods you’d like to use with a site like ModDrop and unzip them into the “Mods” folder of your game’s folder.
  • Configure your game client so it runs the modded version of Stardew Valley .
Section 1 of 6:

Using Windows

PDF download Download Article
  1. Download and install SMAPI . Extract the zipped file to your Downloads folder so it’s easy to access.
    • SMAPI is a specialized modding framework that allows mods to run on Stardew Valley . The base download works for Windows, Mac, and Linux devices (including Steam Deck devices).
  2. Check out sites like Nexus Mods and ModDrop , which offer comprehensive catalogs of different mods, along with ratings. Use the “search” function on these websites to find the exact mod that you’re looking for.
    Advertisement
  3. Extract the mod file into the Mods folder attached to your Stardew Valley game file. Here’s where you can find your game folder, depending on your client:
    • Steam: C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley
    • GOG: C:\GOG Games\Stardew Valley or C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley
    • Xbox app: C:\XboxGames\Stardew Valley
  4. Using the files you extracted earlier, install SMAPI onto your computer by clicking on the install on Windows.bat file. Instructions will pop up on your screen—follow them to finish up the installation process. While keeping this installation window open, configure your game client so it runs SMAPI rather than the default game:
    • Steam: Select the provided text in the installer window, which reads like ”[File path]” %command% . Then, open Steam, right-click on the Properties option, and click on the “Launch Options” part of the “General” menu. In the box, paste what you copied from the installer window.
    • GOG: Create a new Notepad file with the following text: start "" "C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\StardewModdingAPI.exe" . Save this file as start.bat . Then, open up the GOG client, open up the settings for Stardew Valley , and click on “Manage installation” followed by “Configure.” Toggle the “Custom executables/arguments” box, click the “Add another executable/arguments” option, and choose the start.bat file that you made earlier. After selecting this file, click on the “Default executable” option.
    • Xbox app: Click the ... button on the Stardew Valley profile, along with the “Browse…” button within the “Files” tab. Once you’ve opened the Stardew Valley > Content folder, copy the complete file path. Install SMAPI as you normally would, but paste the file path when the installation window prompts you to. Once SMAPI is completely installed, go to your game folder ( C:\XboxGames\Stardew Valley ) and rename the .exe file to Stardew Valley original.exe . Then, duplicate the StardewModdingAPI.exe file and change the name to Stardew Valley.exe . [1]
  5. After you’ve configured your client, the modded version of Stardew Valley should boot up when you start playing the game.
  6. Advertisement
Section 2 of 6:

Using Mac

PDF download Download Article
  1. Download SMAPI and unzip it into your Downloads folder. There’s only one version of the SMAPI file, but it works on all operating systems.
  2. Follow the instructions on the installation terminal that pops up. [2]
  3. Go to your Stardew Valley game folder to locate the Mods subfolder. Here’s where you can find it:
    • Steam: ~/Library/Application Support/Steam/SteamApps/common/Stardew Valley/Contents/MacOS
    • GOG: /Applications/Stardew Valley.app/Contents/MacOS
  4. Search for the mods you’d like on sites like Nexus Mods or ModDrop . After downloading the files, extract them into the Mods folder you’ve just located.
    • Type the mods you’re looking for into the search bar on the website to narrow down your results.
  5. The modded version of the game should boot up. [3]
  6. Advertisement
Section 3 of 6:

Using Linux

PDF download Download Article
  1. You’ll need to install a certain SSL depending on the type of distribution software your Linux device runs. Based on this, open up a terminal and run the following: [4]
    • Arch-based (Manjaro, Arch, EndeavorOS): sudo pacman -S openssl-1.1 .
    • Debian-based (Linux MMint, Debian, Ubuntu): sudo apt install libssl1.1 .
    • Fedora: sudo dnf install openssl1.1
    • RHEL 8-based (Alma 8, CentOS 8, RHEL 8, Rocky 8): sudo dnf install openssl
    • If your machine runs NixOS , execute export NIXPKGS_ALLOW_UNFREE=1 && nix-shell -p steam-run to make a provisional nix-shell using steam-run. After this, open up a terminal and run steam-run ./install\ on\ Linux.sh .
  2. Download SMAPI and unzip the file to your Downloads folder. Make sure that the file isn’t extracted to your Stardew Valley game folder.
  3. Some people find it helpful to run this command with “XTerm”—to do this, simply, right-click on the file and hit the “Open with ‘XTerm.’” [5]
  4. If it requests your game’s file location, enter:
    • For Steam: ~/.local/share/Steam/steamapps/common/Stardew Valley
    • For GOG: ~/GOGGames/StardewValley/game
  5. Visit NexusMods or ModDrop to find a variety of mods to enhance your game—the search bar on the website can help you find the exact mods you’re looking for. Then, download each file and unzip it in the Mods subfolder of your game folder. [6]
    • Access your game folder using the file paths provided in the previous step.
  6. Your Linux device should now run the modded version of Stardew Valley .
  7. Advertisement
Section 4 of 6:

Using Steam Deck (Windows)

PDF download Download Article
  1. Download SMAPI and extract the file in a separate folder. Double-check that you haven’t unzipped SMAPI into your Stardew Valley game file. [7]
  2. This will walk you through how to install SMAPI on your Steam Deck.
  3. Select the “Games” option in the upper menu, along with “Add a Non-Steam Game to My Library.” A new “Add a Game” window will pop up at this point; within it, select the “Browse” option and choose the StardewModdingAPI.exe file.
  4. Find the “StardewModdingAPI” game that’s now in your Steam library, tap the gear icon, and go to the “Compatibility” portion of the menu. Click on the checkbox that says “Force the use of a specific Steam Play compatibility tool,” and then choose a Proton version from the dropdown list below. [8]
    • Proton enables your Steam Deck to play the Windows version of Stardew Valley .
  5. Download your desired mods from a site like ModDrop . Using the site’s search bar, type in the mod you’d like to download for your game. The mod will be downloaded in a zipped file.
    • Nexus Mods is another great site to search for mods.
  6. Once you’ve downloaded your desired mods, unzip them into the Mods subfolder of your game. You can find your game folder here:
    • Steam: ~/.local/share/Steam/steamapps/common/Stardew Valley
    • GOG: ~/GOGGames/StardewValley/game
  7. Make sure that you’re choosing the modded program rather than the original one.
  8. Advertisement
Section 5 of 6:

Using Steam Deck (Linux)

PDF download Download Article
  1. Download SMAPI for Linux devices. Unzip the file into a separate folder, so it isn’t in the same location as your game folder. [9]
  2. If you’d rather take a manual installation approach, find the readme that goes with your SMAPI and follow the provided instructions.
  3. Visit a site like ModDrop or Nexus Mods and use the site’s search bar to find and download your desired mods. The file will be zipped.
  4. Extract your mods into your game’s Mods subfolder, which is accessible here:
    • Steam: ~/.local/share/Steam/steamapps/common/Stardew Valley
    • GOG: ~/GOGGames/StardewValley/game
  5. It should be visible in your Steam library.
  6. Advertisement
Section 6 of 6:

Popular Stardew Valley Mods

PDF download Download Article
  1. This mod introduces new NPCs into the game, along with different character events and new locations. It even gives you new farm maps to peruse when you first start the game.
  2. This mod serves as an add-on to the TV that comes automatically in your Farmhouse. It also lets you create bots that handle some of your daily chores.
  3. This mod provides your Farm with a large, varied plot of land that gives you more opportunities to mine, forage, fish, and care for your animals.
  4. This mod includes an aquarium in the Town, which can be filled with the different types of Fish you catch in the game.
  5. Much like an actual farm, this mod gives you the option to turn your animals into meat, along with a new way to have your animals reproduce.
  6. This mod lets you ride around on a skateboard throughout the map.
  7. This mod gives you the opportunity to purchase a tractor, which streamlines chores like tilling soil and planting seeds.
  8. This mod lets you live with both a roommate and a spouse, and also allows you to have multiple spouses.
  9. This mod provides anime-style portraits for all of the NPCs in the game.
  10. Advertisement


Expert Q&A

Ask a Question
      Advertisement

      Tips

      Submit a Tip
      All tip submissions are carefully reviewed before being published
      Name
      Please provide your name and last initial
      Thanks for submitting a tip for review!

      About This Article

      Thanks to all authors for creating a page that has been read 45,341 times.

      Did this article help you?

      Advertisement