Line 7: |
Line 7: |
| | | |
| ==Breaking changes for SMAPI mods== | | ==Breaking changes for SMAPI mods== |
− | ===Stardew Valley compatibility branch===
| |
− | Stardew Valley 1.5.5 is available in two branches on each OS (with identical content for players): the ''main branch'' which is installed by default, and an optional ''compatibility branch'' for [https://www.stardewvalley.net/compatibility older systems]. These have identical content for players, but use different technologies:
| |
− |
| |
− | {| class="wikitable"
| |
− | |-
| |
− | ! branch
| |
− | ! OS
| |
− | ! game framework
| |
− | ! runtime
| |
− | |- style="color: #090;"
| |
− | |rowspan="2"| main
| |
− | | Linux/macOS
| |
− | | MonoGame 3.8
| |
− | | 64-bit .NET 5
| |
− | |- style="color: #090;"
| |
− | | Windows
| |
− | | MonoGame 3.8
| |
− | | 64-bit .NET 5
| |
− | |- style="color: #900;"
| |
− | |rowspan="2"| compatibility
| |
− | | Linux/macOS
| |
− | | MonoGame 3.5.1
| |
− | | 64-bit Mono 4.5
| |
− | |- style="color: #900;"
| |
− | | Windows
| |
− | | XNA Framework 4.0
| |
− | | 32-bit .NET Framework 4.5
| |
− | |}
| |
− |
| |
− | Unfortunately '''SMAPI only supports the main branch of the game.''' There are formidable difficulties across all mods in supporting all three variations, the [https://store.steampowered.com/hwsurvey Steam hardware stats] show that ≈99.69% of players have 64-bit, and 32-bit imposes significant restrictions on what mods can do.
| |
− |
| |
| ===64-bit MonoGame and .NET 5=== | | ===64-bit MonoGame and .NET 5=== |
| Stardew Valley 1.5.5 migrates to 64-bit MonoGame and .NET 5 on all platforms. SMAPI rewrites mods so they should mostly still work, but posting an update for every C# mod is strongly recommended to avoid edge cases. | | Stardew Valley 1.5.5 migrates to 64-bit MonoGame and .NET 5 on all platforms. SMAPI rewrites mods so they should mostly still work, but posting an update for every C# mod is strongly recommended to avoid edge cases. |
Line 103: |
Line 72: |
| |} | | |} |
| | | |
− | ===Consistent game assembly name=== | + | ===Game compatibility branch=== |
| + | Stardew Valley 1.5.5 is available in two branches on each OS (with identical content for players): the ''main branch'' which is installed by default, and an optional ''compatibility branch'' for [https://www.stardewvalley.net/compatibility older systems]. These have identical content for players, but use different frameworks: |
| + | |
| + | {| class="wikitable" |
| + | |- |
| + | ! branch |
| + | ! OS |
| + | ! game framework |
| + | ! runtime |
| + | |- style="color: #090;" |
| + | |rowspan="2"| main |
| + | | Linux/macOS |
| + | | MonoGame 3.8 |
| + | | 64-bit .NET 5 |
| + | |- style="color: #090;" |
| + | | Windows |
| + | | MonoGame 3.8 |
| + | | 64-bit .NET 5 |
| + | |- style="color: #900;" |
| + | |rowspan="2"| compatibility |
| + | | Linux/macOS |
| + | | MonoGame 3.5.1 |
| + | | 64-bit Mono 4.5 |
| + | |- style="color: #900;" |
| + | | Windows |
| + | | XNA Framework 4.0 |
| + | | 32-bit .NET Framework 4.5 |
| + | |} |
| + | |
| + | Unfortunately '''SMAPI only supports the main branch of the game.''' There are formidable difficulties across all mods in supporting all three variations, the [https://store.steampowered.com/hwsurvey Steam hardware stats] show that ≈99.69% of players have 64-bit, and 32-bit imposes significant restrictions on what mods can do. |
| + | |
| + | ===Game assembly name=== |
| Previously the game assembly was <code>Stardew Valley</code> on Windows, and <code>StardewValley</code> on Linux and macOS. The assembly is now named <code>Stardew Valley</code> on all platforms. Most mods shouldn't be affected once you update the mod build package. | | Previously the game assembly was <code>Stardew Valley</code> on Windows, and <code>StardewValley</code> on Linux and macOS. The assembly is now named <code>Stardew Valley</code> on all platforms. Most mods shouldn't be affected once you update the mod build package. |
| | | |