SMAPI/release-notes.md

Release notes

1.4 (upcoming)

See log.

For players:

• The installer will now automatically detect most custom install paths.
• The installer will now automatically clean up old SMAPI files.
• SMAPI will now prevent mods from crashing your game due to broken custom menus.
• Each mod now has its own .cache folder, so removing the mod won't leave orphaned cache files behind.
• Improved installer wording to reduce confusion.
• Fixed the installer not removing TrainerMod from appdata if it's already in the game mods directory.
• Fixed the installer not moving mods out of appdata if the game isn't installed on the same Windows partition.
• Fixed the SMAPI console not being shown on Linux and Mac.

For developers:

• Added a reflection API (via helper.Reflection) that simplifies robust access to the game's private fields and methods.
• Added a searchable list_items console command to replace the out_items, out_melee, and out_rings commands.
• Added TypeLoadException details when intercepted by SMAPI.
• Fixed an issue where you couldn't debug into an assembly because it was copied into the .cache directory. That will now only happen if necessary.

1.3

See log.

For players:

• You can now run most mods on any platform (e.g. run Windows mods on Linux/Mac).
• Fixed the normal uninstaller not removing files added by the 'SMAPI for developers' installer.

1.2

See log.

For players:

• Fixed compatibility with some older mods.
• Fixed mod errors in most event handlers crashing the game.
• Fixed mod errors in some event handlers preventing other mods from receiving the same event.
• Fixed game crashing on startup with an audio error for some players.

For developers:

• Improved logging to show ReflectionTypeLoadException details when it's caught by SMAPI.

1.1

See log.

For players:

• Fixed console exiting immediately when some exceptions occur.
• Fixed an error in 1.0 when mod uses config.json but the file doesn't exist.
• Fixed critical errors being saved to a separate log file.
• Fixed compatibility with some older mods.^1.1.1
• Fixed race condition where some mods would sometimes crash because the game wasn't ready yet.^1.1.1

For developers:

• Added new logging interface:
  • easier to use;
  • supports trace logs (written to the log file, but hidden in the console by default);
  • messages are now listed in order;
  • messages now show which mod logged them;
  • more consistent and intuitive console color scheme.
• Added optional MinimumApiVersion to manifest.json.
• Added emergency interrupt feature for dangerous mods.
• Fixed deprecation warnings being repeated if the mod can't be identified.^1.1.1

1.0

See log.

For players:

• Added support for Linux and Mac.
• Added installer to automate adding & removing SMAPI.
• Added background update check on launch.
• Fixed missing steam_appid.txt file.
• Fixed some mod UIs disappearing at a non-default zoom level for some users.
• Removed undocumented support for mods in AppData folder (breaking change).
• Removed F2 debug mode.

For mod developers:

• Added deprecation warnings.
• Added OS version to log.
• Added zoom-adjusted mouse position to mouse-changed event arguments.
• Added SMAPI code documentation.
• Switched to semantic versioning.
• Fixed mod versions not shown correctly in the log.
• Fixed misspelled field in manifest.json schema.
• Fixed some events getting wrong data.
• Simplified log output.

For SMAPI developers:

• Simplified compiling from source.
• Formalised release process and added automated build packaging.
• Removed obsolete and unfinished code.
• Internal cleanup & refactoring.

0.x

• 0.40.1.1 (2016-09-30, log)

  • Added support for Stardew Valley 1.1.

• 0.40.0 (2016-04-05, log)

  • Fixed an error that ocurred during minigames.

• 0.39.7 (2016-04-04, log)

  • Added 'no check' graphics events that are triggered regardless of game's if checks.

• 0.39.6 (2016-04-01, log)

  • Added game & SMAPI versions to log.
  • Fixed conflict in graphics tick events.
  • Bug fixes.

• 0.39.5 (2016-03-30, log)

• 0.39.4 (2016-03-29, log)

• 0.39.3 (2016-03-28, log)

• 0.39.2 (2016-03-23, log)

• 0.39.1 (2016-03-23, log)

• 0.38.8 (2016-03-23, log)

• 0.38.7 (2016-03-23, log)

• 0.38.6 (2016-03-22, log)

• 0.38.5 (2016-03-22, log)

• 0.38.4 (2016-03-21, log)

• 0.38.3 (2016-03-21, log)

• 0.38.2 (2016-03-21, log)

• 0.38.0 (2016-03-20, log)

• 0.38.1 (2016-03-20, log)

• 0.37.3 (2016-03-08, log)

• 0.37.2 (2016-03-07, log)

• 0.37.1 (2016-03-06, log)

• 0.36 (2016-03-04, log)

• 0.37 (2016-03-04, log)

• 0.35 (2016-03-02, log)

• 0.34 (2016-03-02, log)

• 0.33 (2016-03-02, log)

• 0.32 (2016-03-02, log)

• 0.31 (2016-03-02, log)

• 0.3 (2016-03-01, log)

• 0.2 (2016-02-29, log

• 0.1 (2016-02-28)