10
edits
Changes
Jump to navigation
Jump to search
Line 18:
Line 18: − + Line 30:
Line 30: + + + + + + + + + + + + + + Line 52:
Line 66: − + − +
Modding:Installing SMAPI on Windows (view source)
Revision as of 09:42, 23 December 2020
, 09:42, 23 December 2020Added instructions for configuring GOG Galaxy (including a fix so the SMAPI console will display when the game is launched)
:# Extract the <tt>.zip</tt> file somewhere (but not in your game folder! (nor the windows %TEMP% folder)).
:# Extract the <tt>.zip</tt> file somewhere (but not in your game folder! (nor the windows %TEMP% folder)).
:# Double-click <tt>install on Windows.bat</tt>¹, and follow the on-screen instructions.<br />''The installer will detect your game and add SMAPI for you.''<br />Note: if you get the error <code>"Where is your game folder? Oops, couldn't find the game automatically. Type the file path to the game directory (the one containing 'Stardew Valley.exe'), then press enter."</code>, you can go to [[Modding:Player Guide/Getting Started#Find your game folder|this page]] to find your game folder.
:# Double-click <tt>install on Windows.bat</tt>¹, and follow the on-screen instructions.<br />''The installer will detect your game and add SMAPI for you.''<br />Note: if you get the error <code>"Where is your game folder? Oops, couldn't find the game automatically. Type the file path to the game directory (the one containing 'Stardew Valley.exe'), then press enter."</code>, you can go to [[Modding:Player Guide/Getting Started#Find your game folder|this page]] to find your game folder.
:# If you use Steam, continue to the next section. Otherwise just run <tt>StardewModdingAPI.exe</tt> in [[Modding:Player Guide/Getting Started#Find your game folder|your game folder]] to play with mods.
:# If you use Steam, continue to the next section. If you use GOG Galaxy, skip to Part 3. Otherwise just run <tt>StardewModdingAPI.exe</tt> in [[Modding:Player Guide/Getting Started#Find your game folder|your game folder]] to play with mods.
; Part 2: configure Steam
; Part 2: configure Steam
:# Click OK to save your changes.
:# Click OK to save your changes.
:# From now on, just launch the game through Steam to run SMAPI with the Steam overlay and achievements.
:# From now on, just launch the game through Steam to run SMAPI with the Steam overlay and achievements.
; Part 3: configure GOG Galaxy
: You can use SMAPI through the GOG Galaxy client to enable the overlay and track play time. This allows you to launch Stardew Valley with the SMAPI console using GOG Galaxy.
:# Open Notepad and paste in the following: <code>start "" "C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\StardewModdingAPI.exe"</code> If Stardew Valley and SMAPI are not installed at <code>C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\</code>, (the default location for most people), replace that location with the location of where you installed Stardew Valley.
:# Click on File, then Save As... <br />[[File:Save_batch_script.png|800px]]
:# Navigate to your Stardew Valley installation folder and change the file type from Text Documents to All Files as shown below and then click Save. <br />[[File:Choose_batch_extension.png|800px]]
:# Then type <code>start.bat</code> for the file name as shown below <br />[[File:Name_batch_script.png|800px]]
:# In the GOG Galaxy client, click on Stardew Valle' and then the settings icon on the right-hand side of the 'Play' button, then hover over 'Manage installation' and click 'Configure...' as shown below. <br /> [[File:Gog_galaxy_configure.png|800px]]
:# A new menu will appear. Check the "Custom executables / arguments" box. <br />[[File:Gog_galaxy_custom_launch.png|400px]]
:# Then click 'Add another executable / arguments' <br /> [[File:Gog_galaxy_add_exectuable.png|400px]]
:# Select start.bat in the window that appears and then click Open. <br />[[File:Select_batch_file.png|800px]]
:# Finally, click the circle next to 'Default Executable' underneath File 2, then click OK. <br />[[File:Gog_galaxy_select_default_executable.png|400px]]
:# From now on, you can launch Stardew Valley through GOG Galaxy and both the SMAPI console and game will load as expected!
<small>¹ To install manually instead, see instructions in the installer's readme.</small>
<small>¹ To install manually instead, see instructions in the installer's readme.</small>
:# After SMAPI is installed in Vortex, click ''enable'' and you're done!
:# After SMAPI is installed in Vortex, click ''enable'' and you're done!
; Part 2: configure Steam
; Part 2: configure Steam or GOG Galaxy
: See ''Part 2: configure Steam'' under [[#Option A: use SMAPI's installer|''Option A: use SMAPI's installer'']].
: See ''Part 2: configure Steam'' or ''Part 3: configure GOG Galaxy'' under [[#Option A: use SMAPI's installer|''Option A: use SMAPI's installer'']].
==Update SMAPI==
==Update SMAPI==