A lightweight and fast profile manager for Stardew Valley with SMAPI. Switch between different mod sets in a single keypress before starting your game!
- Instant Launch: Select your desired mod preset with a single key press (no Enter needed).
- Profile Management: Support for up to 9 custom mod profiles (
Mods_ProfileName). - Safe & Non-Destructive: Automatically backs up your original
Modsfolder intoMods_Backupon first launch. - Zero Overhead: Launches
StardewModdingAPI.exeand closes itself immediately to free up system resources. - Auto-Restore on Exit/Uninstall: Includes an built-in option to safely restore your original mod setup and remove all preloader files seamlessly.
- Download: Install the latest
SMAPImodpreloader.exefrom the Releases tab (or compile from source). - Place: Unzip folder somwere and run
installer.exeas Administrator. - Auto-delete: auto deletes temporary files and folder with installer
- Steam Launch Options (Optional):
If you want Steam to launch this preloader automatically when clicking Play:
- Open Steam -> Right-click Stardew Valley -> Properties.
- In Launch Options, paste the path to
SMAPImodpreloader.exefrom concole
- Download: Download
SMAPImodpreloader.exefrom the Releases and place it into your main Stardew Valley game folder. - Configure Steam Launch Options Manually: *Open Steam -> Right-click Stardew Valley -> Properties -> General -> Launch Options.
- Enter th path to your SMAPImodpreloader.exe wrapped in quotes, followed by %command% *(Exemple: "C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\SMAPImodpreloader.exe" %command% )
- Run
SMAPImodpreloader.exe. - First Run: If you don't have profiles yet, press
[0]to open Settings Menu. - Create a new profile (e.g.,
FarmorVanillaplus). This will create aMods_Farmfolder in your game directory. - Put your desired mods inside the newly created
Mods_ProfileNamefolder. - Next time you open the preloader, press
[1]–[9]to choose your active profile and launch SMAPI!
[1]Create a new profile: Add up to 9 custom mod presets.[2]Rename a profile: Instantly rename existing mod setups.[3]Delete a profile: Remove a profile and its mod contents completely.[6]Uninstall this program: Restores your originalMods_Backupfolder back toMods, cleans up preloader files, and self-deletes.
- Auto update: Open
SMAPImodpreloader.exe-> Open settings menu ->[4]Update program to latest version. - Auto update2: Download latest version from the Releases -> Unzip folder somwere and run
installer.exeas Admin. - Manual uppdate: Download latest version of
SMAPImodpreloader.exefrom the Releases -> unzip exe file to Stradew folder.
- Auto uninstall: Open
SMAPImodreloader-> Open settings menu -> [6] Uninstall this program - Manual uninstall: Open stradew folder -> Delete
SMAPImodpreloader.exe
- Pyinstaller:
Makse sure you have Pyinstaller, if not install it whith
pip install -U pyinstallercommand. Than you need to download latest sourse code from the Releases and open it whith code editor which u have.' Runpy exe_builder/build.pyand build programm will do all automatically. Opendistfolder and exe files will be dere. - Commands:
if you didnt trust
builder.pyyou can run:py -m PyInstaller --onefile --icon="exe_builder/icon.ico" installer.py ; py -m PyInstaller --onefile --icon="exe_builder/icon.ico" SMAPImodpreloader.py
Note regarding False Positives: Because this executable is packaged using PyInstaller without an expensive commercial code-signing certificate, Windows Defender or SmartScreen may show a warning ("Unknown Publisher" / False Positive).
- To run: Click "More info" -> "Run anyway".
- Alternative: You can review the open-source Python script
SMAPImodpreloader.pyand compile it yourself using PyInstaller