Changes

==Known issues==

==Known issues==

===SMAPI doesn't work with compatibility branch===

===SMAPI doesn't work with compatibility branch===

There's two versions of Stardew Valley {{version|link=0}}: the ''main branch'' which is installed by default, and an optional [https://www.stardewvalley.net/compatibility ''compatibility branch'' for older systems]. These have identical content for players, but [[Modding:Migrate to Stardew Valley 1.5.5#Game compatibility branch|use different frameworks]].

: There's two versions of Stardew Valley {{version|link=0}}: the ''main branch'' which is installed by default, and a legacy [https://www.stardewvalley.net/compatibility ''compatibility branch'' for older systems]. These have identical content for players, but [[Modding:Migrate to Stardew Valley 1.5.5#Game compatibility branch|use different frameworks]].

Unfortunately '''SMAPI only supports the main branch of the game currently.''' There are formidable difficulties across all mods in supporting all three variations, 32-bit imposes significant restrictions on what mods can do, and the [https://store.steampowered.com/hwsurvey Steam hardware stats] show that ≈99.69% of players have 64-bit.

: Unfortunately SMAPI only supports the main branch of the game currently. There are formidable difficulties across all mods in supporting all three variations, 32-bit imposes significant restrictions on what mods can do, and the [https://store.steampowered.com/hwsurvey Steam hardware stats] show that ≈99.69% of players have 64-bit.

Having two versions of SMAPI (like we do for Linux/macOS vs Windows compatibility) wouldn't be enough in this case. Every C# mod author would need to manually port two versions of every update of every mod forever, which is prohibitively unfeasible. It's possible that in the future we'll either figure out how SMAPI can automatically rewrite mods for the compatibility branch, or some modders may port SMAPI and individual mods to the compatibility branch.

: Having multiple versions of SMAPI (like we do for Linux/macOS/Windows compatibility) wouldn't be enough in this case. Every C# mod author would need to manually port two versions of every update of every mod forever, which is prohibitively unfeasible. It's possible that in the future we'll either figure out how SMAPI can automatically rewrite mods for the compatibility branch, or some modders may port SMAPI and individual mods to the compatibility branch.

If you really want to play Stardew Valley with mods using 32-bit system, you can roll back the game to 1.5.4 with [https://github.com/SteamRE/DepotDownloader DepotDownloader] or [https://github.com/Jack-Myth/SteamDepotDownloader-GUI/releases SteamDepotDownloader-GUI] when you are using Steam. However, you can only install [https://www.nexusmods.com/stardewvalley/mods/2400?tab=files&file_id=46226 SMAPI 3.12.8] and older versions of many mods (Updated before November 2021).

 

<li>First, make sure you really can't update. Over 99% of systems should be compatible with the main branch; it's only very old system that are 32-bit-only or use unsupported graphics cards that might not work.</li>

<li>''Or'' you can switch to the game's compatibility branch without mods. Mods don't work with it currently, but it'll continue receiving the same content updates backported to the older frameworks for players with older systems.</li>

<li><p>''Or'' you can rollback to the previous Stardew Valley 1.5.4, so you can continue playing like before. The newest mod updates won't work for you, but you'll be able to install any mod updates up to 29 November 2021. If (or when) we figure out how to make mods work with the compatibility branch in the future, then you'd be able to switch to the compatibility branch instead.</p>

 

 

# Install [https://dotnet.microsoft.com/download/dotnet .NET 5 or later].

# Download the latest [{{github|SteamRE/DepotDownloader}} DepotDownloader] release.

# Run this command (replace <code>&lt;username&gt;</code> and <code>&lt;password&gt;</code> with your Steam login): <pre>dotnet DepotDownloader.dll -app 413150 -depot 413151 -manifest 7802000804251603756 -username <username> -password <password></pre>

# Install SMAPI in the downloaded folder and move your mods over.

# Launch <samp>StardewModdingAPI.exe</samp> in the downloaded folder.

</li>

</ol>

==Get help==

==Get help==