Skip to content
Jacob Jenkins edited this page Jan 26, 2021 · 3 revisions

Welcome to the Stardew Valley Mod Manager Wiki!

Welcome to the world's first fun, fast and 100% browser based Mod Manager for Stardew Valley 🎉

Browser support

As this app uses the very latest File System Access API, it is currently somewhat limited to the very latest versions of Chromium-based browsers. Chrome, Edge, Brave, Opera, Vivaldi, etc. File System Access API arrived in Chrome 86, so any Chromium browser updated after that.

Getting Started

Setting up your mod directory

Due to some current browser limitations, browsers cannot access folders within an OS's "system" files. C:/Program Files or C:/Program Files (x86) for Windows, and dev/, /sys, and /proc for macOS and Linux. So if your mods are currently installed with your Stardew Valley game files, then it's possible this app will be unable to access them directly.

However, there is a very simply work around for this problem! Currently Smapi loads mods from your Stardew Valley/Mods folder, so we can place a symlink in that mods folder to another folder in your user directory which can then be accessed by Stardew Valley Mod Manager!

Symlink command for Windows

First create a folder in your user's documents somewhere. Then open cmd as Administrator and run these commands

cd "C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\Mods" (Or the path to your Stardew Valley install)
mklink /j "SVMM" "C:/Users/Your Name/path/to/your/mod/folder"

Symlink command for macOs / Linux

First create a folder in your user's documents somewhere. Open Terminal, you may need to run this command as sudo.

ln -s "/Users/Your Name/Documents/Stardew Valley Mods" "/path/to/your/Stardew/Valley/install/Mods/folder"

Selecting your mod folder

So now your symlink is set up, if you load up Stardew Valley Mod Manager, you will be asked to choose your mod folder. This will be the folder you just created, this is where all new installed mods will go and where your profile folders live.

Simply choose your folder and you should then see any currently installed mods in that folder.

Profiles

In order to start installing and managing mods, you need to create a Profile. This is simply a collection of mods that you can enable/disable all together; this is very useful for creating a mod folder for Combat say if you fancy a more combat-focused game. Or maybe you want a New characters Profile, full of new characters to come live in your world.

Creating profiles

You can create and choose your current profile in the Navigation at the top of the app.

Deleting profiles

Currently, as this app is still in it's early stages, to prevent any disasters - Profiles must be removed manually at the moment from your main mod directory. To delete a profile, simple delete that Profile's folder! If the Profile you want to delete is currently not your active Profile, it's folder name will be prepended with a period . (this is so that it's hidden from Smapi!)

Managing Mods

Now that you've chosen your Mod directory, created a profile. Now you can begin installing mods!

Installing mods

Currently mods can be installed by selecting the .zip file. SVMM will then read that file and extract in into your profile folder, and there it will be accessible by Smapi!

Enable/disable single mods

You can also enable or disable specific mods within a Profile by simply unticking the box to the left of the mod name, in the main mod list.