Stardew Valley Mod Manager
The Stardew Valley Mod Manager and Modded Framework is an extension to SMAPI, the open-source modding framework API for Stardew Valley that lets players play the game with mods. Much alike SMAPI, The Stardew Valley Mod Manager does not edit or change any of the core game files and is installed as a completely separate executable to both the main game and the SMAPI launcher. This powerful new application allows you to do a variety of different operations pertaining to mod management and game save management. See "Features" for more information about the different things you can do with the Stardew Valley Mod Manager.
Table of Contents
Features
The Stardew Valley Mod Manager comes with a plethora of features pertaining to mod management and game save management.
-
Installing Mods Once you have downloaded your mod from NexusMods, all you need to do is open the Stardew Valley Mod Manager, click "Install Mods" then "Add New Mods (.zip)" and select your ZIP file downloaded from NexusMods. Once the Mod Manager has installed your mod, it will be automatically added to your Disabled Mods List, from which you can enable the mod.
-
Uninstalling Mods Mods can be removed just as easily as they can be installed. Simply disable the mod (if it was enabled) and click the Delete button. Or simply disable the mod and enable it at a later date.
-
Disable and Enable Installed Mods Have mods be disabled without having to delete them entirely. With a click of a button you can move a mod from disabled to enabled and back to disabled. Disabled mods will remain on your system but will not be active when you launch your modded save.
-
Check Mod Updates (Beta) With just a few clicks you can check if a compatible mod is currently up to date. Simply open the "Check for Mod Updates [Beta]" window from the Mod Management screen, select your mod and click "Check for Updates". If the mod is compatible, you'll be able to see if the mod is up to date, and if it isn't, get a link to download the new version.*
-
Save and Load Mod Presets Create mod presets so you can quickly mass enable and disable groups of mods depending on what save you're playing, making mod management that much better. By default, the Stardew Valley Mod Manager comes with a Default preset that includes only SMAPI default mods. Easily revert back to a clean slate with just a few clicks.
-
Modpack Installer Install entire modpacks with just a single file. Simply install a .sdvmp file and let the Mod Manager find the mods, make sure you're running the minimum SMAPI version or above and even let the program create you a preset with the mods defined for the modpack. It's never been easier to install a collection of mods.
-
Backup and Manage Game Saves Create backups and delete any of your farms with built in Game Save Management tools.
*Please note that for a mod to be compatible, it must be configured with NexusMod update keys among some other specific criteria. For more information, click here
Documentation
Important: Please note that due to changes in the application's user interface with version 220501, some of the screenshots used in the documentation may be out of date and may not accurately reflect the visual experience you may be having. We believe that despite this, the instructions are still relevant - the appearance and names of labels, windows and user interface may differ but should still adhere closely enough to the written instructions.
Setup and Configuration
Simply download the latest release of Stardew Valley Mod Manager from this repository and follow the installation prompts. From there, you can keep your Mod Manager updated with the built in update check tools. Please note that you may have trouble with Chrome, Edge and Windows trying to block you from installing the application as it is not a commonly downloaded application.
- Getting Started: Setup and Configuration
- How-To: Downloading the Mod Manager
- How-To: Installing the Mod Manager
- How-To: Setting up the Mod Manager
- How-To: Updating Stardew Valley Mod Manager
- How-To: Navigating the Mod Manager
Using the Mod Manager
To make it easy for you to access, we've established a Wiki that contains a variety of "How-to" articles that outline and explain features and processes. We've got a couple of articles you can access here, or you can click "Visit our Wiki" to see more.
- How-To: Installing Mods
- How-To: Enabling and Disabling Mods
- How-To: Updating Mods
- How-To: Create a Mod Preset
- How-To: Load a Mod Preset
Or for more articles and information, Visit our Wiki
License
It's your responsibility to read the license agreement when installing the software if you intend on using it as much as it's our responsibility to do our best to show it to you. If you're modifying and/or downloading the source code, however, your responsibility to understand what you are and are not permitted to do become even more of a big deal - and it's your responsibility. Please familiarise yourself with our license agreement before even downloading a copy of the source code.
Download
System Requirements
Why does this application need administrative privileges?
Stardew Valley Mod Manager (as of version 230301) requires administraive privileges in order to run. This may be alarming to some users, however, this is in response to some longstanding issues with the Mod Manager on machines where Stardew Valley is installed in the default directory.
When Stardew Valley is installed in a folder that is child to the C:\Program Files\
directory, the Stardew Valley Mod Manager is unable to move folders and files in and out of this directory, as it is protected by the system. For this reason, the application requires administrative privileges so that mods can be installed, enabled, disabled, uninstalled and deleted. It is easier for us to implement a program-wide enforcement of higher privileges than it is to redesign the program to only require priviliges when file transfers are taking place. This is something we are considering for the future however.
As always, the code for the Stardew Valley Mod Manager is completely open source. There is no cause to be alarmed.
Recommended Specifications
Operating System
- Designed for Windows 11
- Windows 10 Compatible
Hardware Requirements
- 300mb Disk Space
- 150mb Disk Space for Installation
- 50mb Disk Space for Download
- 100mb Disk Space for In-App Downloads
Minimum Specifications
Operating System
- Windows 7 or above (Untested)
Hardware Requirements
- 200mb Disk Space
- 150mb Disk Space for Installation
- 50mb Disk Space for Download
Windows Download
Download the most recent version of Stardew Valley Mod Manager by visiting our releases page. Once you have downloaded Stardew Valley Mod Manager and installed the application, you can keep it up to date from within the application, never needing to return to this repository (as of v220401). We recommend downloading our latest release, as it is the most stable release with the most features.
Need Help?
If you're running into any issues with downloading or installing the application, see download and installation help
Branches
Please see a list of branches for this repository: