Modding:Migrate to 64-bit on Windows - Revision history

imported>Pathoschild: redirect to Modding:Migrate to Stardew Valley 1.5.5 (this guide is now entirely obsolete, since the base game migrated to 64-bit in 1.5.5)

2025-01-20T16:11:23Z

redirect to Modding:Migrate to Stardew Valley 1.5.5 (this guide is now entirely obsolete, since the base game migrated to 64-bit in 1.5.5)

Show changes

imported>Pathoschild: /* Enable 64-bit mode */ keep old instructions for historical interest

2021-12-14T21:40:17Z

Enable 64-bit mode: keep old instructions for historical interest

← Older revision		Revision as of 21:40, 14 December 2021
Line 51:		Line 51:

	==Enable 64-bit mode==		==Enable 64-bit mode==
	Stardew Valley 1.5.5 is ~~[https://forums.stardewvalley.net/threads/important-announcement-for-modders-stardew-valley-64-bit.8669/~~ officially 64-bit].		The latest {{version\|1.5.5\|Stardew Valley 1.5.5}} is officially 64-bit, so you don't need to do anything else to enable it.

	<!--~~To enable the beta:~~		{{collapse\|obsolete instructions (August to November 2021)\|content=
			The Stardew Valley 1.5.5 beta is [https://forums.stardewvalley.net/threads/important-announcement-for-modders-stardew-valley-64-bit.8669/ officially 64-bit].

			To enable the beta:
	# Open the Steam client. (The beta isn't available on GOG currently.)		# Open the Steam client. (The beta isn't available on GOG currently.)
	# Right-click ''Stardew Valley'' and choose ''Properties''.		# Right-click ''Stardew Valley'' and choose ''Properties''.
	# Click the ''Betas'' tab.		# Click the ''Betas'' tab.
	# Change the dropdown to <samp>monogame64bit</samp>. (Ignore the 'check code' box.) ~~-->~~		# Change the dropdown to <samp>monogame64bit</samp>. (Ignore the 'check code' box.)

	~~Use SMAPI versions 3.13.2+ for Stardew 1.5.5<!--~~You'll also need the [https://smapi.io/ SMAPI 3.13.0-beta] to play with mods.~~-->~~		You'll also need the [https://smapi.io/ SMAPI 3.13.0-beta] to play with mods.}}

	{{collapse\|obsolete instructions\|content=		{{collapse\|obsolete instructions (March to August 2021)\|content=
	<table style="width: 95%; background-color: rgba(255,192,203,0.8); border: 3px solid maroon; border-radius: 12px; padding: 6px; margin: 0 auto 12px auto;">		<table style="width: 95%; background-color: rgba(255,192,203,0.8); border: 3px solid maroon; border-radius: 12px; padding: 6px; margin: 0 auto 12px auto;">
	<tr>		<tr>

imported>Atravita: /* Enable 64-bit mode */ remove instructions about beta, since 1.5.5 is out of beta.

2021-12-14T07:21:22Z

Enable 64-bit mode: remove instructions about beta, since 1.5.5 is out of beta.

← Older revision		Revision as of 07:21, 14 December 2021
Line 53:		Line 53:
	Stardew Valley 1.5.5 is [https://forums.stardewvalley.net/threads/important-announcement-for-modders-stardew-valley-64-bit.8669/ officially 64-bit].		Stardew Valley 1.5.5 is [https://forums.stardewvalley.net/threads/important-announcement-for-modders-stardew-valley-64-bit.8669/ officially 64-bit].

	To enable the beta:		<!--To enable the beta:

	# Open the Steam client. (The beta isn't available on GOG currently.)		# Open the Steam client. (The beta isn't available on GOG currently.)
	# Right-click ''Stardew Valley'' and choose ''Properties''.		# Right-click ''Stardew Valley'' and choose ''Properties''.
	# Click the ''Betas'' tab.		# Click the ''Betas'' tab.
	# Change the dropdown to <samp>monogame64bit</samp>. (Ignore the 'check code' box.)		# Change the dropdown to <samp>monogame64bit</samp>. (Ignore the 'check code' box.) -->

	You'll also need the [https://smapi.io/ SMAPI 3.13.0-beta] to play with mods.		Use SMAPI versions 3.13.2+ for Stardew 1.5.5<!--You'll also need the [https://smapi.io/ SMAPI 3.13.0-beta] to play with mods.-->

	{{collapse\|obsolete instructions\|content=		{{collapse\|obsolete instructions\|content=

imported>Margotbean: Text replacement - "i.e. " to "''i.e.,'' "

2021-11-08T01:06:38Z

Text replacement - "i.e. " to "''i.e.,'' "

← Older revision		Revision as of 01:06, 8 November 2021
Line 43:		Line 43:
	</syntaxhighlight>		</syntaxhighlight>

	If the mod uses the old project format (i.e. there's no <code><nowiki><Project Sdk="Microsoft.NET.Sdk"></nowiki></code> at the top), see [https://docs.microsoft.com/en-ca/visualstudio/ide/how-to-configure-projects-to-target-platforms ''How to: Configure projects to target platforms''] to set the platform to <samp>Any CPU</samp>.		If the mod uses the old project format (''i.e.,'' there's no <code><nowiki><Project Sdk="Microsoft.NET.Sdk"></nowiki></code> at the top), see [https://docs.microsoft.com/en-ca/visualstudio/ide/how-to-configure-projects-to-target-platforms ''How to: Configure projects to target platforms''] to set the platform to <samp>Any CPU</samp>.
	</li>		</li>
	<li>Fully exit Visual Studio.</li>		<li>Fully exit Visual Studio.</li>

imported>Margotbean: css update

2021-11-06T18:10:25Z

css update

← Older revision		Revision as of 18:10, 6 November 2021
Line 65:		Line 65:
	<table style="width: 95%; background-color: rgba(255,192,203,0.8); border: 3px solid maroon; border-radius: 12px; padding: 6px; margin: 0 auto 12px auto;">		<table style="width: 95%; background-color: rgba(255,192,203,0.8); border: 3px solid maroon; border-radius: 12px; padding: 6px; margin: 0 auto 12px auto;">
	<tr>		<tr>
	<td><~~big~~>'''These instructions are obsolete and kept for historical interest.'''</~~big~~><br />Unofficial 64-bit is not compatible with newer SMAPI versions.</td>		<td><span style="font-size: larger;">'''These instructions are obsolete and kept for historical interest.'''</span><br />Unofficial 64-bit is not compatible with newer SMAPI versions.</td>
	</tr>		</tr>
	</table>		</table>

	<~~big~~>'''Download Linux version'''</~~big~~>		<div style="font-size: larger;">'''Download Linux version'''</div>
	First you'll need a separate Linux version of the game. To download it, follow the instructions for your game platform below. [https://www.youtube.com/watch?v=_qij_OlZmis Here's a video explaining the steps.]		First you'll need a separate Linux version of the game. To download it, follow the instructions for your game platform below. [https://www.youtube.com/watch?v=_qij_OlZmis Here's a video explaining the steps.]

Line 88:		Line 88:
	:# The downloaded game is in the extracted <samp>data/noarch/game</samp> folder.		:# The downloaded game is in the extracted <samp>data/noarch/game</samp> folder.

	<~~big~~>'''Install guide'''</~~big~~>		<div style="font-size: larger;">'''Install guide'''</div>
	# Update all your mods to their latest versions (they might add 64-bit support).		# Update all your mods to their latest versions (they might add 64-bit support).
	# [[#Download Linux version\|Download the Linux version]] if you haven't already.<br />'''This is downloaded into a <u>separate</u> folder. Use the downloaded folder path for the steps below, ''not'' the original game folder.'''		# [[#Download Linux version\|Download the Linux version]] if you haven't already.<br />'''This is downloaded into a <u>separate</u> folder. Use the downloaded folder path for the steps below, ''not'' the original game folder.'''
Line 100:		Line 100:
	That's it! Now run <code>StardewModdingAPI.exe</code> in the downloaded game folder, and the game should be 64-bit!		That's it! Now run <code>StardewModdingAPI.exe</code> in the downloaded game folder, and the game should be 64-bit!

	<~~big~~>'''Troubleshooting'''</~~big~~>		<div style="font-size: larger;">'''Troubleshooting'''</div>
	; Screen tearing		; Screen tearing
	: Some players report [[wikipedia:Screen tearing\|screen tearing]] in 64-bit mode. Common fixes:		: Some players report [[wikipedia:Screen tearing\|screen tearing]] in 64-bit mode. Common fixes:

imported>Margotbean: Text replacement - "tt>" to "samp>"

2021-11-04T18:48:02Z

Text replacement - "tt>" to "samp>"

← Older revision		Revision as of 18:48, 4 November 2021
Line 7:		Line 7:
	The game's ''bitness'' affects how much memory it can use. Since the game is normally 32-bit, it shares the first ≈3GB of memory with every 32-bit app on your computer. In 64-bit mode, it has unlimited access to your computer's memory.		The game's ''bitness'' affects how much memory it can use. Since the game is normally 32-bit, it shares the first ≈3GB of memory with every 32-bit app on your computer. In 64-bit mode, it has unlimited access to your computer's memory.

	32-bit is fine for most players, but those with a large number of mods (or large mods) can experience <tt>OutOfMemoryException</tt> crashes. Changing the game to 64-bit unlocks access to all available memory to avoid that (if the computer itself has enough memory available).		32-bit is fine for most players, but those with a large number of mods (or large mods) can experience <samp>OutOfMemoryException</samp> crashes. Changing the game to 64-bit unlocks access to all available memory to avoid that (if the computer itself has enough memory available).

	===Do I need 64-bit?===		===Do I need 64-bit?===
	You only need this if you play on Windows and experience <tt>OutOfMemoryException</tt> crashes. Otherwise you can just use the default versions, which are simpler and work fine.		You only need this if you play on Windows and experience <samp>OutOfMemoryException</samp> crashes. Otherwise you can just use the default versions, which are simpler and work fine.

	===Will SMAPI drop 32-bit support?===		===Will SMAPI drop 32-bit support?===
Line 28:		Line 28:

	<dl>		<dl>
	<dt>Review <tt>TargetPlatform</tt> constants</dt>		<dt>Review <samp>TargetPlatform</samp> constants</dt>
	<dd>[[Modding:Modder Guide/APIs/Utilities#Constants\|<tt>Constants.TargetPlatform</tt>]] indicates whether the mod is running on Android, Linux, MacOS, or Windows. If you use this to distinguish between XNA Framework (on Windows) and MonoGame (on other platforms), you should use the new <tt>Constants.GameFramework</tt> instead.</dd>		<dd>[[Modding:Modder Guide/APIs/Utilities#Constants\|<samp>Constants.TargetPlatform</samp>]] indicates whether the mod is running on Android, Linux, MacOS, or Windows. If you use this to distinguish between XNA Framework (on Windows) and MonoGame (on other platforms), you should use the new <samp>Constants.GameFramework</samp> instead.</dd>

	<dt>Don't target x86</dt>		<dt>Don't target x86</dt>
	<dd>		<dd>
	New mod projects target <tt>Any CPU</tt> by default. If you explicitly changed it to <tt>x86</tt>, you'll need to change it back to <tt>Any CPU</tt> to avoid errors for 64-bit players.		New mod projects target <samp>Any CPU</samp> by default. If you explicitly changed it to <samp>x86</samp>, you'll need to change it back to <samp>Any CPU</samp> to avoid errors for 64-bit players.

	To fix affected mods:		To fix affected mods:
	<ol>		<ol>
	<li>In each mod's <tt>.csproj</tt> project file, remove these lines if present:		<li>In each mod's <samp>.csproj</samp> project file, remove these lines if present:
	<syntaxhighlight lang="xml">		<syntaxhighlight lang="xml">
	<Platforms>x86</Platforms>		<Platforms>x86</Platforms>
Line 43:		Line 43:
	</syntaxhighlight>		</syntaxhighlight>

	If the mod uses the old project format (i.e. there's no <code><nowiki><Project Sdk="Microsoft.NET.Sdk"></nowiki></code> at the top), see [https://docs.microsoft.com/en-ca/visualstudio/ide/how-to-configure-projects-to-target-platforms ''How to: Configure projects to target platforms''] to set the platform to <tt>Any CPU</tt>.		If the mod uses the old project format (i.e. there's no <code><nowiki><Project Sdk="Microsoft.NET.Sdk"></nowiki></code> at the top), see [https://docs.microsoft.com/en-ca/visualstudio/ide/how-to-configure-projects-to-target-platforms ''How to: Configure projects to target platforms''] to set the platform to <samp>Any CPU</samp>.
	</li>		</li>
	<li>Fully exit Visual Studio.</li>		<li>Fully exit Visual Studio.</li>
	<li>In the <tt>.sln</tt> solution file, replace all instances of <tt>x86</tt> with <tt>Any CPU</tt>.</li>		<li>In the <samp>.sln</samp> solution file, replace all instances of <samp>x86</samp> with <samp>Any CPU</samp>.</li>
	</ol>		</ol>
	</dd>		</dd>
Line 58:		Line 58:
	# Right-click ''Stardew Valley'' and choose ''Properties''.		# Right-click ''Stardew Valley'' and choose ''Properties''.
	# Click the ''Betas'' tab.		# Click the ''Betas'' tab.
	# Change the dropdown to <tt>monogame64bit</tt>. (Ignore the 'check code' box.)		# Change the dropdown to <samp>monogame64bit</samp>. (Ignore the 'check code' box.)

	You'll also need the [https://smapi.io/ SMAPI 3.13.0-beta] to play with mods.		You'll also need the [https://smapi.io/ SMAPI 3.13.0-beta] to play with mods.
Line 83:		Line 83:
	:# Install Python through the Microsoft Store.		:# Install Python through the Microsoft Store.
	:# From your [https://www.gog.com/account GOG web library]: click Stardew Valley, change the ''System'' dropdown to Linux, and download the installer file shown in the list.		:# From your [https://www.gog.com/account GOG web library]: click Stardew Valley, change the ''System'' dropdown to Linux, and download the installer file shown in the list.
	:# Download <tt>gogextract.py</tt> from {{github\|Yepoleb/gogextract\|Yepoleb/gogextract}} into the folder containing the above download.		:# Download <samp>gogextract.py</samp> from {{github\|Yepoleb/gogextract\|Yepoleb/gogextract}} into the folder containing the above download.
	:# Open a command prompt in the same folder and run this command (correcting the <tt>.sh</tt> filename if needed): <pre>python gogextract.py stardew_valley_1_5_4_981587505_44377.sh stardew-valley-installer</pre>		:# Open a command prompt in the same folder and run this command (correcting the <samp>.sh</samp> filename if needed): <pre>python gogextract.py stardew_valley_1_5_4_981587505_44377.sh stardew-valley-installer</pre>
	:# In the extracted folder, unzip <tt>data.zip</tt>.		:# In the extracted folder, unzip <samp>data.zip</samp>.
	:# The downloaded game is in the extracted <tt>data/noarch/game</tt> folder.		:# The downloaded game is in the extracted <samp>data/noarch/game</samp> folder.

	<big>'''Install guide'''</big>		<big>'''Install guide'''</big>
Line 107:		Line 107:

	; "''Unhandled exception: System.Reflection.TargetInvocationException: [...] Could not load file or assembly 'SMAPI.Toolkit[...]''"		; "''Unhandled exception: System.Reflection.TargetInvocationException: [...] Could not load file or assembly 'SMAPI.Toolkit[...]''"
	: Make sure you run <tt>StardewModdingAPI.exe</tt>, ''not'' <tt>StardewValley.exe</tt>. The 64-bit version of the game won't work without SMAPI.		: Make sure you run <samp>StardewModdingAPI.exe</samp>, ''not'' <samp>StardewValley.exe</samp>. The 64-bit version of the game won't work without SMAPI.

	; Help with other issues		; Help with other issues

imported>Pathoschild: update with instructions to get Stardew Valley 1.5.5 beta

2021-09-03T02:39:19Z

update with instructions to get Stardew Valley 1.5.5 beta

← Older revision		Revision as of 02:39, 3 September 2021
Line 1:		Line 1:
	←[[Modding:Index\|Index]]		←[[Modding:Index\|Index]]

	~~{\| style="background-color: rgba(255,192,203,0.8); border: 3px solid maroon; border-radius: 12px; max-width: 80%; padding: 6px; margin: 0 auto 12px auto;"~~
	\|-
	~~\| <big>'''This page is obsolete and kept for historical interest.'''</big><br />The game is officially 64-bit starting with [https://www.patreon.com/posts/55035968 Stardew Valley 1.5.5 beta].~~
	\|}

	This page explains how to enable 64-bit Stardew Valley.		This page explains how to enable 64-bit Stardew Valley.
Line 56:		Line 51:

	==Enable 64-bit mode==		==Enable 64-bit mode==
	===Download Linux version~~===~~		Stardew Valley 1.5.5 is [https://forums.stardewvalley.net/threads/important-announcement-for-modders-stardew-valley-64-bit.8669/ officially 64-bit].

			To enable the beta:

			# Open the Steam client. (The beta isn't available on GOG currently.)
			# Right-click ''Stardew Valley'' and choose ''Properties''.
			# Click the ''Betas'' tab.
			# Change the dropdown to <tt>monogame64bit</tt>. (Ignore the 'check code' box.)

			You'll also need the [https://smapi.io/ SMAPI 3.13.0-beta] to play with mods.

			{{collapse\|obsolete instructions\|content=
			<table style="width: 95%; background-color: rgba(255,192,203,0.8); border: 3px solid maroon; border-radius: 12px; padding: 6px; margin: 0 auto 12px auto;">
			<tr>
			<td><big>'''These instructions are obsolete and kept for historical interest.'''</big><br />Unofficial 64-bit is not compatible with newer SMAPI versions.</td>
			</tr>
			</table>

			<big>'''Download Linux version'''</big>
	First you'll need a separate Linux version of the game. To download it, follow the instructions for your game platform below. [https://www.youtube.com/watch?v=_qij_OlZmis Here's a video explaining the steps.]		First you'll need a separate Linux version of the game. To download it, follow the instructions for your game platform below. [https://www.youtube.com/watch?v=_qij_OlZmis Here's a video explaining the steps.]

Line 75:		Line 88:
	:# The downloaded game is in the extracted <tt>data/noarch/game</tt> folder.		:# The downloaded game is in the extracted <tt>data/noarch/game</tt> folder.

	~~===~~Install guide~~===~~		<big>'''Install guide'''</big>
	# Update all your mods to their latest versions (they might add 64-bit support).		# Update all your mods to their latest versions (they might add 64-bit support).
	# [[#Download Linux version\|Download the Linux version]] if you haven't already.<br />'''This is downloaded into a <u>separate</u> folder. Use the downloaded folder path for the steps below, ''not'' the original game folder.'''		# [[#Download Linux version\|Download the Linux version]] if you haven't already.<br />'''This is downloaded into a <u>separate</u> folder. Use the downloaded folder path for the steps below, ''not'' the original game folder.'''
Line 87:		Line 100:
	That's it! Now run <code>StardewModdingAPI.exe</code> in the downloaded game folder, and the game should be 64-bit!		That's it! Now run <code>StardewModdingAPI.exe</code> in the downloaded game folder, and the game should be 64-bit!

	==Troubleshooting==		<big>'''Troubleshooting'''</big>
	; Screen tearing		; Screen tearing
	: Some players report [[wikipedia:Screen tearing\|screen tearing]] in 64-bit mode. Common fixes:		: Some players report [[wikipedia:Screen tearing\|screen tearing]] in 64-bit mode. Common fixes:
Line 99:		Line 112:
	: See [[Modding:Help]] for the best places to ask.		: See [[Modding:Help]] for the best places to ask.
	: 64-bit mode for Stardew Valley is '''unofficial'''. Don't report bugs to the game developers unless you can reproduce them with the normal game version.		: 64-bit mode for Stardew Valley is '''unofficial'''. Don't report bugs to the game developers unless you can reproduce them with the normal game version.
			}}

	[[Category:Modding]]		[[Category:Modding]]
	[[zh:模组:在_Windows_上使用_64_位游戏]]		[[zh:模组:在_Windows_上使用_64_位游戏]]

imported>Pathoschild: mark page obsolete in favor of Stardew Valley 1.5.5, temporarily link to page with instructions for opting in to beta until it's released

2021-08-19T19:47:51Z

mark page obsolete in favor of Stardew Valley 1.5.5, temporarily link to page with instructions for opting in to beta until it's released

← Older revision		Revision as of 19:47, 19 August 2021
Line 1:		Line 1:
	←[[Modding:Index\|Index]]		←[[Modding:Index\|Index]]

			{\| style="background-color: rgba(255,192,203,0.8); border: 3px solid maroon; border-radius: 12px; max-width: 80%; padding: 6px; margin: 0 auto 12px auto;"
			\|-
			\| <big>'''This page is obsolete and kept for historical interest.'''</big><br />The game is officially 64-bit starting with [https://www.patreon.com/posts/55035968 Stardew Valley 1.5.5 beta].
			\|}

	This page explains how to enable 64-bit Stardew Valley.		This page explains how to enable 64-bit Stardew Valley.

imported>LenneDalben: /* Enable 64-bit mode */Moved the video guide link to the beginning of the section to make it easier to spor

2021-08-12T23:48:27Z

Enable 64-bit mode: Moved the video guide link to the beginning of the section to make it easier to spor

← Older revision		Revision as of 23:48, 12 August 2021
Line 52:		Line 52:
	==Enable 64-bit mode==		==Enable 64-bit mode==
	===Download Linux version===		===Download Linux version===
	First you'll need a separate Linux version of the game. To download it, follow the instructions for your game platform below.		First you'll need a separate Linux version of the game. To download it, follow the instructions for your game platform below. [https://www.youtube.com/watch?v=_qij_OlZmis Here's a video explaining the steps.]

	; From Steam		; From Steam
Line 60:		Line 60:
	:# The downloaded game path is shown in the Steam console.		:# The downloaded game path is shown in the Steam console.

	''Alternatively'', if you're comfortable with the command line, you can use the [https://github.com/SteamRE/DepotDownloader '''DepotDownloader''' open source tool]. In this case, the downloaded folder will be under the <code>depots</code> folder, which itself will be created under whatever folder you were in when you run the tool. ~~[https://www.youtube.com/watch?v=_qij_OlZmis Here's a video explaining the steps.]~~		''Alternatively'', if you're comfortable with the command line, you can use the [https://github.com/SteamRE/DepotDownloader '''DepotDownloader''' open source tool]. In this case, the downloaded folder will be under the <code>depots</code> folder, which itself will be created under whatever folder you were in when you run the tool.

	; From GOG		; From GOG

imported>1059 Studio at 14:24, 5 August 2021

2021-08-05T14:24:41Z

← Older revision		Revision as of 14:24, 5 August 2021
Line 96:		Line 96:

	[[Category:Modding]]		[[Category:Modding]]
			[[zh:模组:在_Windows_上使用_64_位游戏]]