path: root/docs/release-notes.md

← [README](README.md)

# Release notes
## Upcoming release
* For players:
  * Fixed mod edits to the farmhouse shifting the player down one tile in some cases.

* For mod authors:
  * SMAPI now intercepts dictionary duplicate-key errors and adds the key to the error message to simplify troubleshooting. (Due to Harmony limitations, this only works for the dictionary types used by the game.)
  * Fixed map tile rotations/flips not working for farmhands in split-screen mode.
  * Fixed barn/coop exit warps being reset when you edit their interior map.

* For the web UI:
  * Added support for unified [mod data overrides](https://stardewvalleywiki.com/Modding:Mod_compatibility#Mod_data_overrides) defined on the wiki.
  * The mod compatibility list now shows separate beta stats when 'show advanced info' is enabled.

## 3.12.7
Released 18 September 2021 for Stardew Valley 1.5.4.

* For players:
  * Added more progress updates in the log during startup.
  * Simplified asset load error message.
  * Simplified exception logs.
  * Fixed crash loading mods with corrupted translation files.

* For mod authors:
  * Added asset propagation for `LooseSprites\Giftbox`.
  * Improved SMAPI's crossplatform read/writing of `Color`, `Point`, `Rectangle`, and `Vector2` in JSON to support nullable fields too.

* For the web UI:
  * The mod compatibility list now shows the beta status by default (if any).
  * Fixed JSON validator line numbers sometimes incorrect.

## 3.12.6
Released 03 September 2021 for Stardew Valley 1.5.4.

* For players:
  * Added friendly error when using SMAPI 3.2._x_ with Stardew Valley 1.5.5 or later.
  * Improved mod compatibility in 64-bit mode (thanks to spacechase0!).
  * Reduced load time when scanning/rewriting many mods for compatibility.
  * **Dropped support for unofficial 64-bit mode**. You can now use the [official 64-bit Stardew Valley 1.5.5 beta](https://stardewvalleywiki.com/Modding:Migrate_to_64-bit_on_Windows) instead.
  * Updated compatibility list.

* For mod authors:
  * Added `PathUtilities.NormalizeAssetName` and `PathUtilities.PreferredAssetSeparator` to prepare for the upcoming Stardew Valley 1.5.5.
  * **SMAPI no longer propagates changes to `Data/Bundles`.**  
    _You can still load/edit the asset like usual, but if bundles have already been loaded for a save, SMAPI will no longer dynamically update the in-game bundles to reflect the changes. Unfortunately this caused bundle corruption when playing in non-English._
  * Fixed content packs created via `helper.ContentPacks.CreateFake` or `CreateTemporary` not initializing translations correctly.

* For console commands:
  * Added `hurry_all` command which immediately warps all NPCs to their scheduled positions.

**Update note for mod authors:**  
Stardew Valley 1.5.5 will change how asset names are formatted. If you use `PathUtilities.NormalizePath`
to format asset names, you should switch to `PathUtilities.NormalizeAssetName` now so your code will
continue working in the next game update.

## 3.12.5
Released 26 August 2021 for Stardew Valley 1.5.4.

* Fixed some mods in unofficial 64-bit mode no longer loading after SMAPI 3.12.3.

## 3.12.4
Released 25 August 2021 for Stardew Valley 1.5.4.

* For players:
  * Fixed error loading some mods in SMAPI 3.12.3.

## 3.12.3
Released 25 August 2021 for Stardew Valley 1.5.4.

* For players:
  * Added friendly error in 64-bit mode when a mod is 32-bit only.
  * Fixed console encoding issues on Linux/macOS.
  * Fixed some installer errors not showing info header.

* For mod authors:
  * Added `helper.Translation.GetInAllLocales` to get a translation in every available locale.
  * Fixed Visual Studio debugger crash when any mods are rewritten for compatibility (thanks to spacechase0!).
  * Fixed `helper.Data.WriteJsonFile` not deleting the file if the model is null, unlike the other `Write*` methods.
  * Fixed error-handling for `StackOverflowException` thrown on Linux/macOS.
  * Internal changes to prepare for Stardew Valley 1.5.5.

* For the web API:
  * Fixed update checks not shown for prerelease mod versions when you have a SMAPI beta.
  * Fixed update checks shown for prerelease mod versions if you have a working non-prerelease version.

## 3.12.2
Released 05 August 2021 for Stardew Valley 1.5.4.

* For players:
  * Fixed error creating a new save or joining a multiplayer world in 3.12.1.

* For mod authors:
  * Reverted the `Constants.Save*` fix in SMAPI 3.12.1.  
    _The change caused a number of other issues, and is only needed for rare cases where the save folder was invalid. This may be revisited in a future version instead._
  * Fixed `NullReferenceException` in SMAPI's error-handling when trying to handle an invalid `ReflectionTypeLoadException`.

## 3.12.1
Released 03 August 2021 for Stardew Valley 1.5.4.

* For players:
  * The software conflict message is now shown as a warning to simplify troubleshooting.
  * Fixed error loading older Harmony mods for some Windows players using unofficial 64-bit Stardew Valley.
  * Updated compatibility list.

* For mod authors:
  * Fixed `Constants.Save*` fields incorrect if the save's folder name and ID don't match.

## 3.12.0
Released 01 August 2021 for Stardew Valley 1.5.4. See [release highlights](https://www.patreon.com/posts/54388616).

* For players:
  * Added save recovery when content mods leave null objects in the save (in _Error Handler_).
  * Added error if the wrong SMAPI bitness is installed (e.g. 32-bit SMAPI with 64-bit game).
  * Added error if some SMAPI files aren't updated correctly.
  * Added `removable` option to the `world_clear` console command (in _Console Commands_, thanks to bladeoflight16!).
  * Fixed handling of Unicode characters in console commands.
  * Fixed intermittent error if a mod gets mod-provided APIs asynchronously.
  * Fixed crash when creating a farm name containing characters that aren't allowed in a folder path.

* For mod authors:
  * **Updated Harmony 1.2.0.1 to 2.1.0 (see [_migrate to Harmony 2.0_](https://stardewvalleywiki.com/Modding:Migrate_to_Harmony_2.0) for more info).**
  * SMAPI now intercepts `KeyNotFoundException` errors and adds the key to the error message to simplify troubleshooting. (Due to Harmony limitations, this only works for the dictionary types used by the game.)
  * Fixed error loading `.xnb` files from the local mod folder.
  * Fixed reloading a map not correctly reapplying interior doors.

## 3.11.0
Released 09 July 2021 for Stardew Valley 1.5.4. See [release highlights](https://www.patreon.com/posts/53514295).

* For players:
  * Updated for Stardew Valley 1.4.5 multiplayer hotfix on Linux/macOS.
  * Fixed installer error on Windows when running as administrator (thanks to LostLogic!).
  * Fixed installer error on some Windows systems (thanks to eddyballs!).
  * Fixed error if SMAPI fails to dispose on game exit.
  * Fixed `player_add` and `list_items` console commands not including some shirts _(in Console Commands)_.

* For mod authors:
  * Added `World.FurnitureListChanged` event (thanks to DiscipleOfEris!).
  * Added asset propagation for building/house paint masks.
  * Added log message for troubleshooting if Windows software which often causes issues is installed (currently MSI Afterburner and RivaTuner).
  * Improved validation for the manifest `Dependencies` field.
  * Fixed validation for mods with invalid version `0.0.0`.
  * Fixed _loaded with custom settings_ trace log added when using default settings.
  * Fixed `Constants.SaveFolderName` and `Constants.CurrentSavePath` not set correctly in rare cases.

* For the web UI and JSON validator:
  * Updated the JSON validator/schema for Content Patcher 1.23.0.
  * Fixed [JSON schema](technical/web.md#using-a-schema-file-directly) in Visual Studio Code warning about comments and trailing commas.
  * Fixed JSON schema for `i18n` files requiring the wrong value for the `$schema` field.

## 3.10.1
Released 03 May 2021 for Stardew Valley 1.5.4.

* For players:
  * Fixed installer leaving an unneeded `StardewModdingAPI-x64.exe` file in 32-bit game folders.

## 3.10
Released 03 May 2021 for Stardew Valley 1.5.4. See [release highlights](https://www.patreon.com/posts/50764911).

* For players:
  * Added full support for the [unofficial 64-bit Stardew Valley patch](https://stardewvalleywiki.com/Modding:Migrate_to_64-bit_on_Windows), which removes memory limits. The installer detects which version of SMAPI you need, and SMAPI shows update alerts for Stardew64Installer if applicable.
  * Added smarter grouping for skipped mods, so it's easier to see root dependencies to update first.
  * Added crash recovery when the game can't update a map's seasonal tilesheets _(in Error Handler)_. SMAPI will log an error and keep the previous tilesheets in that case.
  * Added installer option to enter a custom game path even if it detected a game folder.
  * `*.ico` files are now ignored when scanning for mods.
  * Fixed error for non-English players after returning to title, reloading, and entering town with a completed movie theater.
  * Fixed `world_clear` console command not removing resource clumps outside the farm and secret woods.
  * Fixed error running SMAPI in a strict sandbox on Linux (thanks to kuesji!).
  * Fixed `StardewModdingAPI.bin.osx` on macOS overwritten with an identical file on launch which would reset file permissions (thanks to 007wayne!).
  * Fixed inconsistent spelling/style for 'macOS'.

* For modders:
  * Added support for [ignoring local map tilesheet files when loading a map](https://stardewvalleywiki.com/Modding:Maps#Local_copy_of_a_vanilla_tilesheet).
  * Added asset propagation for `Data\Concessions`.
  * Added SMAPI version and bitness to the console title before startup to simplify troubleshooting.
  * If a map loads a tilesheet path with no file extension, SMAPI now automatically links it to a `.png` version in the map folder if possible.
  * Improved error-handling during asset propagation.
  * Fixed `Context.IsMainPlayer` returning true for a farmhand in split-screen mode before the screen is initialized.
  * Fixed error when editing bundle data while a split-screen player is joining.
  * Fixed update subkeys not working in file descriptions for Nexus mods marked as adult content.

## 3.9.5
Released 21 March 2021 for Stardew Valley 1.5.4.

* For players:
  * Added console command to reset community center bundles _(in Console Commands)_.
  * Disabled aggressive memory optimization by default.  
    _The option was added in SMAPI 3.9.2 to reduce errors for some players, but it can cause multiplayer crashes with some mods. If you often see `OutOfMemoryException` errors, you can edit `smapi-internal/config.json` to re-enable it. We're experimenting with making Stardew Valley 64-bit to address memory issues more systematically._
  * Fixed bundles corrupted in non-English saves created after SMAPI 3.9.2.  
    _If you have an affected save, you can load your save and then enter the `regenerate_bundles confirm` command in the SMAPI console to fix it._
  * Internal changes to prepare for unofficial 64-bit.

* For mod authors:
  * Improved asset propagation:
    * Added for interior door sprites.
    * SMAPI now updates the NPC pathfinding cache when map warps are changed through the content API.
    * Reduced performance impact of invalidating cached assets before a save is loaded.
    * Fixed asset changes not reapplied in the edge case where you're playing in non-English, and the changes are only applied after the save is loaded, and the player returns to title and reloads a save, and the game reloads the target asset before the save is loaded.
  * Added a second `KeybindList` constructor to simplify single-key default bindings.
  * Added a `Constants.GameFramework` field which indicates whether the game is using XNA Framework or MonoGame.  
    _Note: mods don't need to handle the difference in most cases, but some players may use MonoGame on Windows in upcoming versions. Mods which check `Constants.TargetPlatform` should review usages as needed._

## 3.9.4
Released 07 March 2021 for Stardew Valley 1.5.4.

* For players:
  * Fixed installer error if the `Mods` folder doesn't exist in 3.9.3.

## 3.9.3
Released 07 March 2021 for Stardew Valley 1.5.4.

* For players:
  * Added descriptive error if possible when a `PathTooLongException` crashes SMAPI or the installer.
  * The installer window now tries to stay open if it crashed, so you can read the error and ask for help.
  * Fixed console showing _found 1 mod with warnings_ with no mods listed in some cases.

* For mod authors:
  * Added three stages to the specialised [`LoadStageChanged` event](https://stardewvalleywiki.com/Modding:Modder_Guide/APIs/Events#Specialised): `CreatedInitialLocations`, `SaveAddedLocations`, and `ReturningToTitle`.
  * Fixed `RewriteMods` option ignored when rewriting for OS compatibility.
  * Fixed edge case when playing as a farmhand in non-English where translatable assets loaded via `IAssetLoader` weren't reapplied immediately when the server disconnects.

* For the web UI:
  * Updated the JSON validator/schema for Content Patcher 1.21.

## 3.9.2
Released 21 February 2021 for Stardew Valley 1.5.4.

* For players:
  * Added more aggressive memory optimization to reduce `OutOfMemoryException` errors with some mods.
  * Improved error when `Stardew Valley.exe` exists but can't be loaded.
  * Fixed error running `install on Windows.bat` in very rare cases.
  * Fixed `world_settime` command not always updating outdoor ambient lighting _(in Console Commands)_.

* For mod authors:
  * Added early detection of disposed textures so the error details are more relevant _(in Error Handler)_.
  * Added error details when an event command fails _(in Error Handler)_.
  * Fixed asset propagation for `TileSheets/ChairTiles` not changing existing map seats.
  * Fixed edge case when playing in non-English where translatable assets loaded via `IAssetLoader` would no longer be applied after returning to the title screen unless manually invalidated from the cache.

* For the web UI:
  * Updated compatibility list for the new wiki.
  * Updated the JSON validator/schema for Content Patcher 1.20.
  * Fixed mod compatibility list error if a mod has no name.

* For SMAPI developers:
  * Fixed SMAPI toolkit defaulting the mod type incorrectly if a mod's `manifest.json` has neither `EntryDll` nor `ContentPackFor`. This only affects external tools, since SMAPI itself validates those fields separately.

## 3.9.1
Released 25 January 2021 for Stardew Valley 1.5.4.

* For players:
  * Fixed _tile contains an invalid TileShe