Modding:Installing SMAPI on Windows - Revision history

imported>Pathoschild: /* Launch SMAPI as a non-Steam game */ make it clearer that these are optional instructions which most players don't need

2025-03-20T17:29:50Z

Launch SMAPI as a non-Steam game: make it clearer that these are optional instructions which most players don't need

← Older revision		Revision as of 17:29, 20 March 2025
Line 34:		Line 34:

	====Launch SMAPI as a non-Steam game====		====Launch SMAPI as a non-Steam game====
	Alternatively, you can add SMAPI as a non-Steam game ~~if you would like~~ separate ~~Steam~~ play buttons for an unmodded and modded version of the game.		Alternatively, you can add SMAPI as a non-Steam game to have separate play buttons in the Steam client for an unmodded and modded version of the game.

	~~To configure it~~ this ~~alternate way:~~		Most players don't need to do this.

			{{collapse\|expand optional instructions\|content=
	# Keep SMAPI's installer window open, as in the previous method. <br /><small>(If you already closed it, just run it again. No need to uninstall first.)</small>		# Keep SMAPI's installer window open, as in the previous method. <br /><small>(If you already closed it, just run it again. No need to uninstall first.)</small>
	# Copy the text in the installer window as above, without the <code>%command%</code> portion.		# Copy the text in the installer window as above, without the <code>%command%</code> portion.
Line 46:		Line 48:

	You can now select play on StardewModdingAPI (or its alternate title) and SMAPI will launch, preserving the original "Stardew Valley" entry in your Steam Library for use in playing the unmodded game. The Steam overlay will still be available, and Steam recognizes that Stardew Valley is being run as well, adding to your playtime. Achievements will also work as usual, as Stardew Valley is recognized by Steam as being active when SMAPI is being run.		You can now select play on StardewModdingAPI (or its alternate title) and SMAPI will launch, preserving the original "Stardew Valley" entry in your Steam Library for use in playing the unmodded game. The Steam overlay will still be available, and Steam recognizes that Stardew Valley is being run as well, adding to your playtime. Achievements will also work as usual, as Stardew Valley is recognized by Steam as being active when SMAPI is being run.
			}}

	===GOG Galaxy===		===GOG Galaxy===

imported>Pathoschild: remove sub-sub-sections from TOC

2025-03-20T17:18:13Z

remove sub-sub-sections from TOC

← Older revision		Revision as of 17:18, 20 March 2025
Line 5:		Line 5:
	See instructions for: [[Modding:Installing SMAPI on Android\|Android]] • [[Modding:Installing SMAPI on Linux\|Linux]] • [[Modding:Installing SMAPI on Mac\|macOS]] • [[Modding:Installing SMAPI on Steam Deck\|Steam Deck]].		See instructions for: [[Modding:Installing SMAPI on Android\|Android]] • [[Modding:Installing SMAPI on Linux\|Linux]] • [[Modding:Installing SMAPI on Mac\|macOS]] • [[Modding:Installing SMAPI on Steam Deck\|Steam Deck]].

	~~__TOC__~~		{{TOC\|limit=3}}

	==Install SMAPI==		==Install SMAPI==

imported>Pathoschild: /* Steam */ add subsection for non-Steam-game approach so it can be linked

2025-03-20T17:16:51Z

Steam: add subsection for non-Steam-game approach so it can be linked

← Older revision		Revision as of 17:16, 20 March 2025
Line 20:		Line 20:
	==Configure your game client==		==Configure your game client==
	===Steam===		===Steam===
			====Launch SMAPI by default (recommended)====
	You need to launch SMAPI through Steam if you want the Steam overlay, achievements, and playtime tracking to work. (If you don't care about achievements or tracking game time, you can just launch {{executable name\|StardewModdingAPI}} in [[Modding:Player Guide/Getting Started#Find your game folder\|your game folder]] to play with mods.)		You need to launch SMAPI through Steam if you want the Steam overlay, achievements, and playtime tracking to work. (If you don't care about achievements or tracking game time, you can just launch {{executable name\|StardewModdingAPI}} in [[Modding:Player Guide/Getting Started#Find your game folder\|your game folder]] to play with mods.)

Line 32:		Line 33:
	# 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.

			====Launch SMAPI as a non-Steam game====
	Alternatively, you can add SMAPI as a non-Steam game if you would like separate Steam play buttons for an unmodded and modded version of the game.		Alternatively, you can add SMAPI as a non-Steam game if you would like separate Steam play buttons for an unmodded and modded version of the game.

imported>Pathoschild: remove old commented-out instructions

2024-12-19T18:28:42Z

remove old commented-out instructions

@@ Line 16: / Line 16: @@
 <small>¹ To install manually instead, see instructions in the installer's readme.</small>
 <span id="Launch_SMAPI_through_Steam_or_GOG_Galaxy"></span>
@@ Line 106: / Line 86: @@
 ==Update SMAPI==
 Just [[#Install SMAPI|install the new version]]; the installer will automatically clean up previous versions. (You don't need to configure Steam or GOG Galaxy again.)
 ==Uninstall==

imported>Peaw at 18:19, 8 August 2024

2024-08-08T18:19:58Z

← Older revision		Revision as of 18:19, 8 August 2024
Line 166:		Line 166:
	[[fr:Modding:Installer SMAPI sur Windows]]		[[fr:Modding:Installer SMAPI sur Windows]]
	[[ru:Моддинг:Установка SMAPI на Windows]]		[[ru:Моддинг:Установка SMAPI на Windows]]
			[[tr:Modlama:Windows'ta SMAPI İndirme]]
	[[zh:使用模组:在Windows上安装SMAPI]]		[[zh:使用模组:在Windows上安装SMAPI]]

imported>Margotbean: category

2024-08-07T20:20:25Z

imported>Milkants: /* Configure your game client */

2024-03-22T06:45:04Z

Configure your game client

← Older revision		Revision as of 06:45, 22 March 2024
Line 64:		Line 64:
	# (Optional) In the Steam client, right-click on ''StardewModdingAPI'' and choose ''Properties''. You can now change the title of StardewModdingAPI to whatever you would like in the top field - it is suggested to title it "SMAPI" or "Stardew Valley Modded" (without quotations) if you do not wish to keep the original name. (This will not alter your installation in any way, it will simply change the title of the mod client in your Steam Library.)		# (Optional) In the Steam client, right-click on ''StardewModdingAPI'' and choose ''Properties''. You can now change the title of StardewModdingAPI to whatever you would like in the top field - it is suggested to title it "SMAPI" or "Stardew Valley Modded" (without quotations) if you do not wish to keep the original name. (This will not alter your installation in any way, it will simply change the title of the mod client in your Steam Library.)

	You can now select play on StardewModdingAPI (or its alternate title) and SMAPI will launch, preserving the original "Stardew Valley" entry in your Steam Library for use in playing the unmodded game. The Steam overlay will still be available, and Steam recognizes that Stardew Valley is being run as well, adding to your playtime. (Achievements ~~are currently untested for this method, but should~~ work as usual, as Stardew Valley is recognized by Steam as being active when SMAPI is being run.)		You can now select play on StardewModdingAPI (or its alternate title) and SMAPI will launch, preserving the original "Stardew Valley" entry in your Steam Library for use in playing the unmodded game. The Steam overlay will still be available, and Steam recognizes that Stardew Valley is being run as well, adding to your playtime. Achievements will also work as usual, as Stardew Valley is recognized by Steam as being active when SMAPI is being run.

	===GOG Galaxy===		===GOG Galaxy===

imported>Margotbean at 22:57, 6 August 2023

2023-08-06T22:57:05Z

← Older revision		Revision as of 22:57, 6 August 2023
Line 162:		Line 162:
	[[de:Modding:SMAPI auf Windows]]		[[de:Modding:SMAPI auf Windows]]
	[[es:Modding:Instalar SMAPI en Windows]]		[[es:Modding:Instalar SMAPI en Windows]]
			[[fr:Modding:Installer SMAPI sur Windows]]
	[[ru:Моддинг:Установка SMAPI на Windows]]		[[ru:Моддинг:Установка SMAPI на Windows]]
	[[zh:使用模组:在Windows上安装SMAPI]]		[[zh:使用模组:在Windows上安装SMAPI]]
	~~[[fr:Modding:Installer SMAPI sur Windows]]~~

imported>Gathou at 21:44, 6 August 2023

2023-08-06T21:44:53Z

← Older revision		Revision as of 21:44, 6 August 2023
Line 164:		Line 164:
	[[ru:Моддинг:Установка SMAPI на Windows]]		[[ru:Моддинг:Установка SMAPI на Windows]]
	[[zh:使用模组:在Windows上安装SMAPI]]		[[zh:使用模组:在Windows上安装SMAPI]]
			[[fr:Modding:Installer SMAPI sur Windows]]

imported>AgentLyoko: Edited the launch options portion to add a comment given the most common error (in the discord)

2022-10-20T15:57:26Z

Edited the launch options portion to add a comment given the most common error (in the discord)

← Older revision		Revision as of 15:57, 20 October 2022
Line 49:		Line 49:
	# Click the textbox under ''Launch Options'':<br />[[File:Modding - installing SMAPI on Windows - Steam 2.png]]		# Click the textbox under ''Launch Options'':<br />[[File:Modding - installing SMAPI on Windows - Steam 2.png]]
	# Replace anything in the textbox with the text you copied from the installer.<br /><small>To paste text, click in the box and press {{key\|CTRL}} and {{key\|V}}.</small>		# Replace anything in the textbox with the text you copied from the installer.<br /><small>To paste text, click in the box and press {{key\|CTRL}} and {{key\|V}}.</small>
	# This text should consist of "Your SMAPI API Filepath" %command% <br /><small>Default for most users is <code>"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%</code></small>		# This text should consist of "Your SMAPI API Filepath" %command% <br /><small>Default for most users is <code>"C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley\StardewModdingAPI.exe" %command%</code></small><br /><small>The quotes - and %command% - are both necessary, so include them!</small>
	# 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.

← Older revision		Revision as of 20:20, 7 August 2024
Line 159:		Line 159:
	\|next =		\|next =
	}}		}}

			[[Category:Modding]]

	[[de:Modding:SMAPI auf Windows]]		[[de:Modding:SMAPI auf Windows]]