Troubleshooting

📂 Docs / Start / Troubleshooting

Last updated: 2025-08-10 Applies to Stardew Valley: 1.6.15+

📖 This guide will be available right on the Nexus Collection page soon!

Quick Fix: Try Restarting First!

Before diving into complex troubleshooting steps, restart your computer and try again. Many issues with Vortex, SMAPI, or the game itself can be resolved with a simple restart. This is often the fastest solution and can save you a lot of time!

Part 1 — Vortex Profile Check (Only collection mods selected)

  1. On the Nexus Mods collection page, click Add Collection.

  2. When prompted, install into a New Profile.

  3. In Vortex, switch to that profile and confirm only the collection's mods are enabled (no leftovers or personal add-ons).

  4. Ensure Optional Mods are ticked for full functionality.

Part 2 — Game Mods Folder Check (Only mods Vortex knows about)

  1. In Vortex → Mods tab, click Purge to remove all active mods from the game folder.

  2. Click Open → Game Mods Folder and manually delete any files/folders left behind.

  3. Back in Vortex, click Deploy to put the clean set of mods back.

Part 3 — Game Installation Check (Game itself is healthy)

  1. Use your store launcher to verify integrity of game files (fast reinstall):

    • Steam: Library → Stardew Valley → Properties → Installed Files → Verify

    • GOG: More → Manage Installation → Verify / Repair

    • Xbox / Game Pass: Right-click game → Manage → Files → Verify and Repair

Need More Help?

If you run into issues that aren't solved here, you can:

  • Reach out to our community on Discord for live assistance

  • Create and share a SMAPI log so others can help diagnose your issue

Further Support

For Vortex support:

  • Official Vortex Discord: Join Here

  • Support Hours: 9 AM – 5 PM GMT, Monday–Thursday

More help available:

The official Stardew Valley Discord does not support Vortex. Please respect their policy.

Additional Resources for Expansion Mods

If you're experiencing issues with specific expansion mods, these resources may help:

Stardew Valley Expanded

Ridgeside Village

East Scarp & Lurking in the Dark, Sword & Sorcery, etc

Important: Please avoid troubleshooting in these Discords unless you can show (via log) a repeatable error from their mod without the rest of the collection active.

How to Create a SMAPI Log

A SMAPI log is a text file that shows what mods loaded and any errors that occurred.

Windows Users:

  1. Press the Windows and R keys at the same time.

  2. In the 'Run' box that appears, enter:

    %appdata%\StardewValley\ErrorLogs

  3. Look for one of these files:

    • SMAPI-crash.txt (if the game crashed)

    • SMAPI-latest.txt (normal log from your last game session)

Mac/Linux Users:

Visit smapi.io/log for platform-specific instructions.

What to do with your log:

  1. Upload it to smapi.io/log

  2. Share the link in our Discord for help!

Tip: The log will show exactly which mods loaded successfully and highlight any problems in red.

Quick Links

PreviousKeybinds & ControllersNextFAQ & Known Issues

Last updated