New Player Install Instructions
Step-by-step installation guide for Stardew Valley mod collections using Vortex. Learn how to install collections, set up SMAPI, handle optional mods, and resolve conflicts.
Last updated: 2026-01-19 Applies to Stardew Valley: 1.6.15+
This guide walks you through installing a mod collection using Vortex, step by step. Follow these instructions in order for the best experience.
Not a new player, or need a different installation method?
Installing Multiple Collections - For combining collections together
Installing to Existing Saves - For installing collections to saves that already have mods
Manual Installation - For users who can't use mod managers
Sideload to Stardrop - For Stardrop users
Sideload to Steam Deck - For Steam Deck users
Using a Controller - For controller-specific setup
Table of Contents
Verifying Game Files
Before installing mods, make sure your game files are healthy and up to date.
Why Verify?
Ensures you have the latest game version (required for mod compatibility)
Fixes any corrupted game files
Prevents installation issues
Always verify and run the game before installing mods. This ensures your game is ready for modding.
How to Verify
Steam:
Open Steam Library
Right-click Stardew Valley
Select Properties > Installed Files
Click Verify integrity of game files
GOG:
Open GOG Galaxy
Right-click Stardew Valley
Select Manage Installation > Verify / Repair
Xbox / Game Pass:
Open Xbox app
Right-click Stardew Valley
Select Manage > Files > Verify and Repair
After Verifying
Run the game once through your normal launcher (Steam, GOG, etc.)
Let it complete the initial setup
Close the game
Manage Stardew Through Vortex
Vortex needs to know you want to manage Stardew Valley mods.
Initial Setup
Download and install Vortex Mod Manager if you haven't already
Open Vortex
Go to the Games tab
Find Stardew Valley in the list
Click Manage (or Manage Stardew Valley)
Vortex will now detect and manage Stardew Valley mods.
Symbolic Links (Important for Non-C: Drives)
If Stardew Valley is not installed on drive C:\, you need to enable symbolic links:
Go to Settings (gear icon in Vortex)
Navigate to Mods section
Enable Use Symbolic Links
Click Apply
Symbolic links allow Vortex to manage mods even when the game is on a different drive. Without this, mods may not deploy correctly.
Clearing Your Mod Folder
Before installing a collection, you need a clean slate. Any existing mods or leftover files can cause conflicts.
If you have other Stardew Valley mods managed in Vortex, disable them.
In the Mods tab, click Open > Game Mods Folder
Remove everything from this folder (files and subfolders)
Close the folder window
Old mod files can conflict with collection mods, causing crashes, missing content, or other issues. Starting fresh ensures everything works correctly.
Installation Process
Follow these steps to install a collection. Browse available Jenna Juffuffles' collections
Step-by-Step Installation
Ensure Vortex is open
Click Add Collection on the collection page
Pop-up in browser will ask you to use a Mod Manager, click Continue
Vortex will display the collection, click Install Now
For Premium users: Vortex handles everything automatically
For Free users: You'll need to click buttons to download the mods from the pages Vortex opens for you. All mods are hosted on Nexus.
When prompted about optional mods, click OK/Install
Optional mods may have additional instructions, and you may skip or install each
Installing Multiple Collections
You can combine multiple collections (for example, Stardew Valley VERY Expanded with an Aesthetic Valley collection) by installing them to the same Vortex profile.
See Installing Multiple Collections for detailed guidance on combining collections, resolving conflicts, and managing optional mods.
Nexus Premium vs Free
The installation process differs based on whether you have Nexus Premium or are using the free version.
Nexus Premium:
Fully automated downloads - All mods download automatically
Fewer manual steps - Just click "Add Collection" and let it run
Faster installation - No waiting for individual downloads
Free Version:
Step-by-step prompts - Vortex guides you through each mod
Manual downloads required - You'll need to download each mod from Nexus
Both methods result in the same installed collection. Premium saves time, but collections are kept small to make them easier for free users to download manually through Vortex.
Optional Mods
Collections include required mods and optional mods. Here's what you need to know:
Required Mods
These are essential and must be installed:
Core framework mods (like SMAPI)
Mods that other mods depend on
Critical gameplay mods
You cannot skip these - the collection is intended to be installed with these mods.
Optional Mods
Optional mods are included for different reasons:
Performance considerations:
Expansion content - Large content mods that may impact performance on lower-end systems
Memory-heavy visual mods - Visual enhancements that require more system resources
Compatibility and conflicts:
Compatibility files - May not be needed depending on your other installed mods
Farm map variations - Only one farm map can be active at a time (conflicts with other farm maps)
Mods that conflict with other collections - Included so you can choose between conflicting options when combining collections
What this means:
You can skip optional mods if you have performance concerns
You can skip optional mods if you're combining both Aesthetic Valley collections and want to avoid conflicts
You can skip optional mods if you don't need specific compatibility files
The collection will work without them, but you may miss features
Recommendation
For first-time installs: Click OK/Install when prompted about optional mods. This gives you the complete, intended experience. Just never enable more than one farm mod.
Installing SMAPI
SMAPI (Stardew Modding API) is the framework that makes mods work. You need to connect it to your game so mods can load.
Installing SMAPI Through Vortex
Easiest method:
SMAPI can be installed as a mod from Nexus Mods
Vortex will automatically detect and install it
SMAPI comes with the collection and should automatically be configured by Vortex.
Verifying SMAPI Connection
Check in Vortex:
Dashboard should show SMAPI as the primary tool
You should see a Launch button in the top left of Vortex that uses SMAPI
Check in-game:
Launch the game from Vortex (click the Launch button)
The game should start with the SMAPI console window
You'll see mod loading messages in the console
If SMAPI isn't working:
Make sure it's set as Primary Tool in Dashboard
Try disabling and reinstalling SMAPI through Vortex
Verify your game files (see Verifying Game Files)
Check the Troubleshooting guide for more help
Connecting SMAPI to Your Store
You need to connect SMAPI to your store launcher if you wish to launch from your store, get achievements, and play co-op. Highly recommended for all users, but technically optional.
SMAPI is installed through the collection, so you don't need to install it separately. You just need to configure your store launcher to use it.
Getting the SMAPI Path
First, you need to find the path to StardewModdingAPI.exe:
In Vortex, go to the Mods tab
Click Open (button at the top)
Select Open Game Folder (second option)
Find
StardewModdingAPI.exein the game folderRight-click on
StardewModdingAPI.exeand select Copy as path
You'll use this path in the steps below for your store launcher.
Steam
Launch SMAPI by default (recommended):
In the Steam client, right-click on Stardew Valley and choose Properties
Click the textbox under Launch Options
Paste the path you copied, then add
%command%at the endThe full text should look like:
"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%Important: Include the quotation marks around the path and then a space and then the
%command%at the end
Click OK
From now on, launching Stardew Valley through Steam will run SMAPI with the Steam overlay, achievements, and playtime tracking.
Reference: SMAPI Wiki - Steam Configuration
GOG Galaxy
Open Notepad and paste:
start "" "YOUR_SMAPI_PATH_HERE"Replace
YOUR_SMAPI_PATH_HEREwith the path you copied (include the quotes)Example:
start "" "C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\StardewModdingAPI.exe"
Click File > Save As
Navigate to your Stardew Valley game folder
Change Save as type to All Files
Name the file
start.batand click SaveIn GOG Galaxy, click on Stardew Valley > settings icon > Manage installation > Configure
Enable the "Custom executables / arguments" checkbox
Click Add another executable / arguments
Select
start.batand click OpenEnable the Default Executable radio button under the section you just added
Click OK
From now on, launching Stardew Valley through GOG Galaxy will run SMAPI with playtime tracking.
Reference: SMAPI Wiki - GOG Galaxy Configuration
Xbox App
Mods work with the Xbox app, but require a few extra steps:
In your game folder (found via Vortex: Mods > Open > Open Game Folder):
Rename
Stardew Valley.exetoStardew Valley original.exeMake a copy of
StardewModdingAPI.exeand name the copyStardew Valley.exe
Launch the game through the Xbox app to play with mods
When the game updates, you'll need to redo these steps (rename the original back and recreate the copy).
Reference: SMAPI Wiki - Xbox App Configuration
De-SVE-ing a Collection
If you want to remove Stardew Valley Expanded (SVE) from a collection while keeping other active mods for a new save:
Step 1: Identify SVE-Related Mods
In Vortex, filter your mods to identify:
Stardew Valley Expanded (main mod)
SVE-related compatibility patches
SVE-specific configuration
Any mods that depend on SVE
For Stardew Valley VERY Expanded this will include:
Stardew Valley Expanded
Stardew Valley Expanded Grampleton Fields
Immersive Farm 2k Remastered
Frontier Farm
Seasonal Cute Characters SVE
Schedule Viewer - SVE Add-on
Animated Fish for SVE
For Aesthetic Valley, the fastest way to tell is to disable Stardew Valley Expanded and watch in SMAPI for what can no longer load.
Stardew Valley Expanded farm maps will not be usable without Stardew Valley Expanded: Frontier Farm, Grandpa's Farm, Immersive Farm Remastered 2K
It is not recommended that you remove Stardew Valley Expanded from an existing save.
Happy farming!
Last updated