Difference between revisions of "Modding:Installing SMAPI on Windows"
Jump to navigation
Jump to search
m (→Update) |
Pathoschild (talk | contribs) (copyedit & simplify new Vortex sections, tweak ModDrop sections to match) |
||
Line 34: | Line 34: | ||
===Option B: use ModDrop=== | ===Option B: use ModDrop=== | ||
− | ModDrop is a mod manager which supports SMAPI. It can install SMAPI, keep it updated, and simplify installing mods. | + | ModDrop is a mod manager which supports SMAPI. It can install SMAPI, keep it updated, and simplify installing/updating mods. |
# [https://www.moddrop.com Install ModDrop] and open the client. | # [https://www.moddrop.com Install ModDrop] and open the client. | ||
Line 40: | Line 40: | ||
# 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. | # 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 | + | ===Option C: use Vortex=== |
− | Vortex is a | + | Vortex is a mod manager by Nexus Mods. It can install SMAPI, keep it updated, and simplify installing/updating mods. |
− | # Log into | + | # Log into a [https://www.nexusmods.com Nexus Mods] account. |
− | # | + | # 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. | |
− | # Click 'Log In or Register' button in the | + | # 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! |
− | # Click the notification bell in the upper right hand corner which will prompt you to download and install | ||
− | # After SMAPI is installed in Vortex, | ||
==Update SMAPI== | ==Update SMAPI== | ||
Line 57: | Line 55: | ||
===Option B: use ModDrop=== | ===Option B: use ModDrop=== | ||
− | If you use the [https://www.moddrop.com ModDrop mod manager] | + | If you use the [https://www.moddrop.com ModDrop mod manager]: |
+ | # Click ''Update Available'' in the top-right if it appears. | ||
+ | # Follow the on-screen instructions. | ||
===Option C: use Vortex=== | ===Option C: use Vortex=== | ||
− | If you | + | If you use the [https://www.nexusmods.com/about/vortex/ Vortex mod manager]: |
+ | # Go to {{nexus mod|2400|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== | ==Uninstall== |
Revision as of 04:52, 17 July 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.
- 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!
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.)