Difference between revisions of "Modding:Installing SMAPI on Windows"
Jump to navigation
Jump to search
Pathoschild (talk | contribs) (copyedit & simplify new Vortex sections, tweak ModDrop sections to match) |
Pathoschild (talk | contribs) (→Option C: use Vortex: + Part 2: configure Steam) |
||
Line 43: | Line 43: | ||
Vortex is a mod manager by Nexus Mods. It can install SMAPI, keep it updated, and simplify installing/updating mods. | Vortex is a mod manager by Nexus Mods. It can install SMAPI, keep it updated, and simplify installing/updating mods. | ||
− | # Log into a [https://www.nexusmods.com Nexus Mods] account. | + | ; Part 1: install SMAPI |
− | # Install and launch [https://www.nexusmods.com/about/vortex/ Vortex]. | + | |
− | # Click the ''Log In or Register'' button in the upper-middle part of the Vortex main screen. A web browser should open asking whether to authorize Vortex to sync with your Nexus Mods account. That enables the ''Mod Manager Download'' buttons on Nexus mod pages. Accept the authorization. | + | :# Log into a [https://www.nexusmods.com Nexus Mods] account. |
− | # Set up Stardew Valley in Vortex by clicking the left-hand ''games'' tab, finding Stardew Valley, and clicking it. You may wish to set up the download folder locations as well in the left-hand ''Settings'' tab. | + | :# Install and launch [https://www.nexusmods.com/about/vortex/ Vortex]. |
− | # Click the notification bell in the upper-right hand corner, which will prompt you to download and install SMAPI. | + | :# Click the ''Log In or Register'' button in the upper-middle part of the Vortex main screen. A web browser should open asking whether to authorize Vortex to sync with your Nexus Mods account. That enables the ''Mod Manager Download'' buttons on Nexus mod pages. Accept the authorization. |
− | # After SMAPI is installed in Vortex, click ''enable'' and you're done! | + | :# Set up Stardew Valley in Vortex by clicking the left-hand ''games'' tab, finding Stardew Valley, and clicking it. You may wish to set up the download folder locations as well in the left-hand ''Settings'' tab. |
+ | :# Click the notification bell in the upper-right hand corner, which will prompt you to download and install SMAPI. | ||
+ | :# After SMAPI is installed in Vortex, click ''enable'' and you're done! | ||
+ | |||
+ | ; Part 2: configure Steam | ||
+ | : See ''Part 2: configure Steam'' under [[#Option A: use SMAPI's installer|''Option A: use SMAPI's installer'']]. | ||
==Update SMAPI== | ==Update SMAPI== |
Revision as of 21:47, 4 August 2020
This page explains how to install SMAPI (the tool which lets you use mods) on Windows. See also:
Install
Option A: use SMAPI's installer
- See also unofficial video guide.
- Part 1: install SMAPI
- Run the game without SMAPI at least once (so it can do first-time setup).
- Download the latest version of SMAPI.
- Extract the .zip file somewhere (but not in your game folder! (nor the windows %TEMP% folder)).
- Double-click install on Windows.bat¹, and follow the on-screen instructions.
The installer will detect your game and add SMAPI for you. - If you use Steam, continue to the next section. Otherwise just run StardewModdingAPI.exe in your game folder to play with mods.
- Part 2: configure Steam
- You can use SMAPI through the Steam client to enable the overlay and achievements. This requires a few more steps.
- Keep SMAPI's installer window open.
(If you already closed it, just run it again. No need to uninstall first.) - Copy the text in the installer window that looks like this (see how to copy text):
Make sure you copy the entire line, including both quotation marks"
and the%command%
part.
Your final path should look something like this:"Your path here" %command%
- In the Steam client, right-click on Stardew Valley and choose Properties:
- Click General > Set Launch Options:
- Replace anything in the textbox with the text you copied from the installer.
To paste text, click in the box and press CTRL and V. - Click OK to save your changes.
- From now on, just launch the game through Steam to run SMAPI with the Steam overlay and achievements.
- Keep SMAPI's installer window open.
¹ To install manually instead, see instructions in the installer's readme.
Option B: use ModDrop
ModDrop is a mod manager which supports SMAPI. It can install SMAPI, keep it updated, and simplify installing/updating mods.
- Install ModDrop and open the client.
- In the top-right corner, click Install SMAPI or Update Available.
- A window should appear that says something like "A new version of SMAPI is available." Click the Install button and follow the on-screen instructions.
Option C: use Vortex
Vortex is a mod manager by Nexus Mods. It can install SMAPI, keep it updated, and simplify installing/updating mods.
- Part 1: install SMAPI
- Log into a Nexus Mods account.
- Install and launch Vortex.
- Click the Log In or Register button in the upper-middle part of the Vortex main screen. A web browser should open asking whether to authorize Vortex to sync with your Nexus Mods account. That enables the Mod Manager Download buttons on Nexus mod pages. Accept the authorization.
- Set up Stardew Valley in Vortex by clicking the left-hand games tab, finding Stardew Valley, and clicking it. You may wish to set up the download folder locations as well in the left-hand Settings tab.
- Click the notification bell in the upper-right hand corner, which will prompt you to download and install SMAPI.
- After SMAPI is installed in Vortex, click enable and you're done!
- Part 2: configure Steam
- See Part 2: configure Steam under Option A: use SMAPI's installer.
Update SMAPI
Option A: use SMAPI's installer
Just install the new version; the installer will automatically clean up previous versions. (You don't need to configure Steam again.)
Option B: use ModDrop
If you use the ModDrop mod manager:
- Click Update Available in the top-right if it appears.
- Follow the on-screen instructions.
Option C: use Vortex
If you use the Vortex mod manager:
- Go to SMAPI's mod page and download it using the Mod Manager Download button.
- Click Open Vortex when the popup appears.
- Click the Vortex window, and the notification bell will appear with a notification in the upper right. Click install and then enable.
Uninstall
- Run install.exe and choose uninstall.
- Blank the Steam launch options (if you changed them).
(If you want to play without mods temporarily, you can just launch Stardew Valley.exe directly instead.)