SMAPI - Stardew Modding API
🟡 Updated this year⚠️ Install Order · 2 steps
Install in this order, then this mod last — most mods fail to load without their framework and dependencies in place.
Preview
🔍 Analysis
- 👍 1.3% endorsement rate — high engagement, a strong quality signal
- 🏆 #1 of 119 Modding Tools mods in this game by downloads
📋 About This Mod
SMAPI is the mod loader for Stardew Valley. It works fine with GOG and Steam achievements, it's compatible with Linux/macOS/Windows, you can uninstall it anytime, and there's a friendly community if you need help. SMAPI is required for most types of Stardew Valley mod.
Install SMAPI
See the player's guide to modding (or skip to install steps). To update SMAPI, download the new version and run its installer; it'll clean up the old version automatically.
For Android phones: see installing SMAPI on Android instead. This page is not for Android.
Get help
-
[]See Modding:Help on the wiki!
See also
- [
[]Privacy notes
[]Donate to support SMAPI ♥
- For mod creators: modding documentation and SMAPI source code
SMAPI is the essential mod loader for Stardew Valley, enabling players to install and manage mods. With over 376,000 endorsements and 29.2 million downloads, it's the backbone of the modding community. Last updated in March 2026, it remains actively maintained, making it a must-have for any modded playthrough.
✨ Key Features
📊 Pros & Cons
✅ Pros
- The absolute foundation for Stardew modding—if you want mods, you need this.
- Huge community trust: 376k endorsements and 29M downloads speak for themselves.
- Regular updates keep it working with the latest game patches.
⚠️ Cons
- Requires installation before any other mods, adding an extra step for newbies.
- Not a content mod itself—you'll still need to find and install other mods.
- Potential compatibility issues with older mods if they haven't been updated for the latest SMAPI version.
For any Stardew Valley player who wants to use mods—this is the first thing you install. Whether you're a casual player looking for quality-of-life tweaks or a hardcore modder with dozens of mods, SMAPI is non-negotiable. Skip it only if you plan to play completely vanilla.
💡 Beginner Tips
- Download SMAPI from the official Nexus page and run the installer—it will automatically detect your Stardew Valley installation.
- After installing, launch the game through the SMAPI launcher (or Steam with the 'SMAPI' launch option) to ensure mods load.
- Check the SMAPI console output on startup for any error messages or mod conflicts—it's your best friend for troubleshooting.
📊 Mod Details
- Game
- Stardew Valley Mods
- Author
- Pathoschild
- Version
- 4.5.2
- Downloads
- 29,166,682
- Endorsements
- 376,337
- Category
- Modding Tools
- Created
- 6/16/2018
- Updated
- 3/14/2026
🔧 How to Install Stardew Valley Mods
Download from Nexus.
📖 Full step-by-step install guide for Stardew Valley →
Visit the official mod page for specific installation instructions for this mod.
🎮 Need cheat codes or console commands? Check ur gaming wiki for Stardew Valley commands, item IDs, and more.
Keep browsing — more Stardew Valley mods await