SMAPI

SMAPI 2.7 mainly makes the console output a bit more intuitive, revamps the installer, and adds a color scheme selector on Linux/Mac. For modders, it mainly adds support for reading .json files through the content API, changes JSON serialisation for all enums, adds a --mods-path CLI argument, and fixes a number of issues.

Requires Stardew Valley 1.3.28 or later on Linux/Mac/Windows.

SMAPI 2.8-beta adds support for Stardew Valley 1.3.32-beta, and makes some quality-of-life changes for players:

• added support for organising your mods into subfolders and ignoring mod folders;
• moved most SMAPI files into a smapi-internal subfolder, so your game folder is less messy;
• moved save backups into a save-backups folder so they're easier to find;
• enabled update checks even for mods that have no update keys in many cases;
• improved various error messages to be more clear and intuitive;
• now auto-recovers crashes caused by broken modded dialogue;
• now recommends the correct SMAPI version when you have an older game version;
• improved compatibility for some Linux players.

For modders, this mainly...

• adds a multiplayer API and events to send/receive messages and get connected player info;
• adds a data API;
• adds a verbose logging feature;
• adds support for writing to JSON files in content packs;
• adds support for semitransparent overlays when patching images;
• adds more events for the upcoming SMAPI 3.0;
• improves support for the -unofficial version convention (e.g. 1.0-unofficial < 1.0-beta);
• enables IntelliSense documentation when using the non-developers version of SMAPI.

Requires Stardew Valley 1.3.32 beta or later on Linux/Mac/Windows. Note that many mods broke in Stardew Valley 1.3.32 and have not been updated yet.

Beta release notes:

• beta 3:
  • For players:
    • Added support for more game install paths.
    • Fixed security exceptions in the Windows installer.
  • For modders:
    • Added support for deleting data saved through the data API.
    • Added optional 'paranoid warnings' mode for mods using potentially sensitive .NET APIs.
• beta 4:
  • For players:
    • Added support for parallel unofficial updates when there's a Stardew Valley or SMAPI beta.
    • Fixed transparency issues on Linux/Mac for some mod images.
    • Fixed 'no update keys' warning not shown for mods with only invalid update keys.
    • Fixed installer not removing a file added in SMAPI 2.8.
    • Updated compatibility list.
  • For modders:
    • Mods are no longer prevented from loading a PNG while the game is drawing.
• beta 5:
  • For players:
    • Improved various error messages to be more clear and intuitive.
    • SMAPI now prevents a crash caused by mods adding dialogue the game can't parse.
    • Fixed error when mods add an unnamed location.
    • Fixed Linux compatibility issues for some players. SMAPI will now always use xterm if it's available.
    • Fixed translation issues not shown as warnings.
    • Fixed dependencies not correctly enforced if the dependency is installed but failed to load.
    • Updated compatibility list.
  • For modders:
    • Added support for overlaying image assets with semi-transparency using the content API.
    • Added more events for the upcoming SMAPI 3.0.
    • Added SkillType enum constant.
    • When comparing mod versions, SMAPI now considers -unofficial to be lower-precedence than any other value (e.g. 1.0-beta is now considered newer than 1.0-unofficial regardless of normal sorting).
    • Fixed trace logs not showing path for invalid mods.
    • Fixed mod web API returning a concatenated name for mods with alternate names.
• beta 6:
  • For players:
    • Added support for ignoring mod folders.
    • SMAPI now recommends a compatible SMAPI version if you have an older game version.
    • You can now mark a mod folder ignored by starting the name with a dot (like .disabled mods).
    • Fixed friendly error no longer shown when SMAPI isn't run from the game folder.
    • Fixed crash log deleted immediately when you relaunch the game.
    • Updated compatibility list.
  • For modders:
    • Added multiplayer API and events to send/receive messages and get connected player info.
    • Added a verbose logging feature.
    • Fixed Context.IsPlayerFree being true before the player finishes transitioning to a new location in multiplayer.
    • Updated dependencies (Harmony 1.0.9.1 → 1.2.0.1, Mono.Cecil 0.10 → 0.10.1).
    • Deprecated:
      • Non-string manifest versions are now deprecated and will stop working in SMAPI 3.0. Affected mods should use a string version, like "Version": "1.0.0".
      • ISemanticVersion.Build is now deprecated and will be removed in SMAPI 3.0. Affected mods should use ISemanticVersion.PrereleaseTag instead.
  • For the web UI:
    • Added a mod compatibility page and privacy page.
    • Fixed log parser instructions for Mac.
• beta 7:
  • Updated for Stardew Valley 1.3.32.
  • Improved compatibility with various Linux shells (thanks to lqdev!).
  • Fixed multiplayer API not syncing context correctly for a farmhand connected via Steam friends.
  • For the web UI:
    • Added filters to mod compatibility list.
    • Tweaked log parser UI (thanks to danvolchek!).