The fastest way: use SMAPI and Nexus Mods

Most Stardew Valley mods run through SMAPI (Stardew Modding API), a tool that loads mods when the game starts. You read SMAPI from smapi.io, install it into your game folder, then add individual mods from Nexus Mods — the largest mod repository for the game. This route works on Windows, Mac, and Linux.

The process takes about 15 minutes the first time. After SMAPI is set up, adding new mods is just downloading a file and dropping it into your Mods folder. No additional steps needed.

Key Takeaways

  • SMAPI is the mod loader you install once; Nexus Mods is where you read individual mods from creators.
  • read SMAPI from smapi.io, extract it to your Stardew Valley game folder, and run the installer included in the read.
  • Create a free Nexus Mods account, search for the mod you want, read it, and move the folder into your Mods directory.
  • Mods can conflict with each other or break when the game updates, so start with one or two and test before adding more.
  • Never read mods from random websites — stick to Nexus Mods or the official mod list on the Stardew Valley wiki.

Finding your Stardew Valley game folder

Before you install SMAPI, you need to know where Stardew Valley lives on your computer. On Windows, right-click the game in Steam, select Properties, then Local Files, then Browse. On Mac, the game folder is usually in your Applications folder. On Linux, it depends on your distribution, but Steam typically stores games in ~/.steam/steam/steamapps/common/Stardew Valley.

Write down or bookmark this path — you will need it in the next step. Do not move the game folder after you install SMAPI, or the mod loader will not find it.

Installing SMAPI step by step

Go to smapi.io and read the version for your operating system. Extract the downloaded file (usually a .zip) to your Stardew Valley game folder — the same folder where you found StardewValley.exe or the Mac equivalent. Open the extracted SMAPI folder and run the installer file inside it. On Windows, this is install.bat; on Mac and Linux, it is install.sh.

The installer will ask you to confirm the game folder path. If it is wrong, type the correct path. Once installation finishes, you will see a new Mods folder inside your game directory. This is where mods go. Launch the game through Steam as usual — SMAPI runs automatically in the background.

If the game starts and you see a SMAPI console window (a black box with text), SMAPI installed correctly. Close it and play normally. The console appears every time you launch the game; you can minimize it or close it without stopping the game.

Downloading mods from Nexus Mods

Create a free account on nexusmods.com and search for Stardew Valley mods. Read the mod description and the comments section — other players often report conflicts or issues. Check the "Requirements" section to see if the mod needs other mods to work. Most mods list SMAPI as a requirement, which you have already installed.

Click the read button. Nexus will ask where to save the file; save it to your Downloads folder. The read is usually a .zip file. Extract it — on Windows, right-click and select Extract All; on Mac, double-click; on Linux, use your file manager or the command line. Move the extracted folder (not the .zip) into your Mods folder inside your game directory.

Launch the game. If the mod loaded, you will see it listed in the SMAPI console. If something went wrong, the console will show an error message. Read it carefully — it usually tells you what is missing or broken.

Avoiding conflicts and keeping mods working

Mods can interfere with each other, especially if two mods change the same game mechanic. Start with one or two mods and play for a few in-game days before adding more. This way, if something breaks, you know which mod caused it. The SMAPI console shows warnings and errors as you play — if you see red text, that is a sign a mod has a problem.

When Stardew Valley updates, some mods break because they relied on code that changed. Check Nexus Mods for updates to your installed mods. Most mod creators update within a few days of a game patch. If a mod has not been updated in months and the game has updated since, it may no longer work. The mod page usually shows the last update date.

If a mod stops working, remove it from your Mods folder and restart the game. Do not delete it — move it to a backup folder in case you want to reinstall it later when it is updated.

Mods that do not use SMAPI

A small number of Stardew Valley mods work differently — they replace game files directly instead of using SMAPI. These are riskier because they can break more easily and conflict more often. Stick to SMAPI mods unless you have a specific reason not to. The Nexus Mods page for each mod clearly states whether it uses SMAPI or requires file replacement.

If you do use file-replacement mods, back up your original game files first. On Steam, right-click the game, select Properties, Local Files, and Verify Integrity of Game Files. This restores any files you accidentally changed.

Frequently Asked Questions

Will mods get me banned from multiplayer?

No. Stardew Valley's multiplayer does not detect or punish mods. Other players in your world will not see your mods unless they install the same ones. Mods that change appearance or add items only show up on your screen.

Can I use mods on the Nintendo Switch or mobile version?

No. SMAPI only works on PC (Windows, Mac, Linux). Console and mobile versions do not support mods. If you want to use mods, you need the PC version from Steam or GOG.

What if SMAPI will not install or the game will not start?

Check that you extracted SMAPI to the correct game folder and ran the installer. On Windows, make sure you have administrator rights. If the game still will not start, remove all mods from your Mods folder and try again. If it starts without mods, a mod is causing the problem — add them back one at a time to find which one.

Do I need to uninstall SMAPI to play without mods?

No. SMAPI only loads mods if they are in your Mods folder. If the folder is empty, the game runs normally. You can leave SMAPI installed and add or remove mods whenever you want.

Where can I find a list of mods that work together?

The Stardew Valley wiki has a mod list and compatibility guide. Nexus Mods also lets you sort by popularity and rating, which usually means the mod is stable and well-maintained. Read the comments on each mod page — players often mention which other mods they use together.