Stardew Valley SMAPI Mod Manager
⚪ Last updated 2021⚠️ 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
- 👍 4.9% endorsement rate — high engagement, a strong quality signal
- 🏆 #69 of 130 Miscellaneous mods in this game by downloads
📋 About This Mod
1. 4 Update:
There were some bugs to be had with multilevel directories and how to dealt with internal parts of the mod with a manifest. These have now been fixed!
1. 3 Update:
Made to manage the directories better and to fix some bugs and compatibility issues, this version should hopefully be the last one for a while, unless someone else makes a suggestion I feel would benefit the program to add. (I've said that before, haha)
1. 2. 1 Update:
Just some bug fixes that were breaking the sub directory usage.
1. 2 Update:
So, another update rolls out. I'm going strong with this. I took some more suggestions from the feedback.
The program now deals with multi-directory issues, doing so by checking each folder for a manifest.json. Any sub-directories of the folder with the manifest.json won't be counted and are considered part of that mod. The downside is the names in the listbox can get long, so I compensated for this by adding a text label below them that shows the full name of the last clicked mod.
A button to open the Mods folder you're currently targeting has been added. (If you download the first 1. 2 version, uh, forgot to rebuild after adding this. Please redownload if you don't see it)
The update alerts are less grating. It will only alert when there's an update, or if it can't connect to the internet to check.
There is a list of recent loadouts now. The last 20 loadouts that were saved or loaded will be under file > recent loadouts.
The bug where you had to manually enter .load is fixed.
1. 1 Update:
So, there was an idea in the comments I couldn't resist adding. You can now save loadouts and load them to change the mods! Any mods not specified in the .load file will be added to their current status location (if they're disabled, they'll be put there and so on). I also fixed a bug with multiple selection moves. By the by, a detail I forgot to mention for the last update is there is an updating system. It just compares a SHA256 code embedded in the program to the key file on the github repo and will offer to link you to this page if they don't match. Simple, but effective, I hope. As always, please report any bugs and they'll be stomped as soon as I can manage. I've tried to be more thorough on my error messages so I can get plenty of info from errors. Enjoy everyone!
1. 0 Update:
So, I found something out about SMAPI that I don't think is very well known. That is, mod folders that have a period in front of them are ignored. So, one thing I've wanted is a manager for all the mods I've loaded so I can easily switch them in and out. Finding out that SMAPI ignores these folders meant I could build a tool that would add and remove the period for me. And thus, this simple mod manager was born. It was written in C# to start with, though I may do a different language
A simple SMAPI mod manager for Stardew Valley, rewritten in Python. It helps manage mods for the game, with over 2,500 endorsements and 51,000 downloads. Last updated in January 2021, so it may be outdated for current game versions.
✨ Key Features
📊 Pros & Cons
✅ Pros
- Community-approved with 2,543 endorsements and over 51k downloads—clearly fills a need.
- Lightweight Python-based tool, perfect if you want something simpler than a full mod manager.
- Simple to use—just point it at your mods folder and it handles the rest.
⚠️ Cons
- Last updated in January 2021—may not support the latest Stardew Valley or SMAPI versions.
- Python requirement might be a hurdle if you don't have it installed, and no standalone exe is mentioned.
For Stardew Valley players who want a no-frills mod manager without the bloat of larger tools. If you're comfortable with Python and don't mind a tool that hasn't been updated in a while, this could work. Skip if you need active development or a GUI with advanced features.
💡 Beginner Tips
- Make sure you have Python installed and added to your PATH, as the mod manager runs on it.
- Before using, verify your SMAPI version matches the game version—this tool may not handle updates automatically.
- If you're on a newer Stardew Valley version, test with a backup of your mods folder first to avoid conflicts.
📊 Mod Details
- Game
- Stardew Valley Mods
- Author
- Akago
- Version
- 1.4
- Downloads
- 51,672
- Endorsements
- 2,543
- Category
- Miscellaneous
- Created
- 12/26/2020
- Updated
- 1/12/2021
🔧 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