SMAPI – Stardew Modding API

Home / + Nude game tools / SMAPI – Stardew Modding API

Using mods for Stardew Valley is easy with SMAPI. It launches the game with mod support and lets mods interact directly with the game code. This mod loader works good with GOG and Steam achievements. Compatibility: Linux/Mac/Windows. Credits: Pathoschild


Description

What does SMAPI do?

SMAPI can do a lot of useful things for you. For example, it will…

  1. Load mods into the game and provide APIs they can use. Many types of mod aren’t possible without SMAPI.
  2. Rewrite mods for cross-platform compatibility, so you can use almost any mod on Linux/Mac/Windows.
  3. Provide APIs and events for mods. SMAPI let patches interact with the game in ways they otherwise couldn’t.
  4. Intercept errors. If a mod crashes or causes an error, SMAPI will intercept the error, show the error details in the console window, and in most cases automatically recover the game.
  5. Provide update checks. SMAPI automatically alerts you when a new version of a mod is available.
  6. Provide compatibility checks. SMAPI automatically detects when a mod is incompatible and disables it before it causes problems.
  7. Back up your save files. SMAPI automatically creates a daily backup of your saves and keeps ten backups, in case something goes wrong.

What’s new in the current version?

SMAPI 2.11.2 fixes compatibility with some Linux distros, and fixes an error on Mac/Linux with some custom maps.

Installation

Installing SMAPI on Linux

Requires Stardew Valley 1.3.36 or later on Linux.

  1. Install the latest version of Mono for your OC (Ubuntu/Debian/Raspbian/CentOS/RHEL/Fedora). The mono-complete package is recommended.
  2. Extract SMAPI 2.11.2 installer.zip file somewhere (but not in your game folder!).
  3. Run the install on Linux.sh file, and follow the on-screen instructions. The installer will detect your game and add SMAPI for you.

That’s it! Just launch the game to play with mods. You don’t need to change your Steam launch options (that’s only needed on Windows).

Uninstall

Run mono install.exe and choose uninstall.

Update

Just install the new version; the installer will automatically clean up previous versions.

Installing SMAPI on Mac

Requires Stardew Valley 1.3.36 or later on Mac.

  • Install the latest version of Mono for Mac (The ‘stable channel’ version is recommended).
  • Open SMAPI 2.11.2 installer .zip file you downloaded to extract its contents.
  • Enable the installer script:
    • Open Launchpad.
    • Type Terminal and select the Terminal app.
    • Enter this command:
mdfind -0 'kMDItemFSName = "install on Mac.command" && kMDItemContentType = "com.apple.terminal.shell-script"' | xargs -0 xattr -d com.apple.quarantine 

(You might see this error: No such xattr: com.apple.quarantine. If so, just ignore it and continue to the next step.)

  • Expand the ‘SMAPI 2.11.2 installer’ folder in your Downloads and double-click install on Mac.command. Then follow the on-screen instructions.

That’s it! Just launch the game to play with mods. You don’t need to change your Steam launch options (that’s only needed on Windows).

Uninstall

  • Open the file install on Mac.command.
  • Choose to uninstall SMAPI.

Update

Just install the new version; the installer will automatically clean up previous versions.

Installing SMAPI on Windows

Requires Stardew Valley 1.3.36 or later on Windows.

Method 1 (Using ModDrop)

ModDrop is a mod manager which supports SMAPI. It can install SMAPI, keep it updated, and simplify installing mods.

  1. Install ModDrop and open the client.
  2. In the top-right corner, click Install SMAPI or Update Available.
  3. A window should appear that says something like “A new version of SMAPI is available.” Click the Install button and follow the on-screen instructions.

Method 2 (Using SMAPI’s installer )

Step 1: Install SMAPI

  1. Run the game without SMAPI at least once (so it can do first-time setup).
  2. Extract SMAPI 2.11.2 installer.zip file somewhere (but not in your game folder! (nor the windows %TEMP% folder)).
  3. Double-click install on Windows.bat¹, and follow the on-screen instructions.
    The installer will detect your game and add SMAPI for you.
  4. If you use Steam, continue to the next section. Otherwise just run StardewModdingAPI.exe in your game folder to play with mods.

Path:
GOG: C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley
or C:\GOG Games\Stardew Valley

Step 2: Configure Steam

You can use SMAPI through the Steam client to enable the overlay and achievements. This requires a few more steps.

  • Keep SMAPI’s installer window open.
    (If you already closed it, just run it again. No need to uninstall first.)
  • Copy the text in the installer window that looks like this:
Make sure you copy the entire line, including both quotes and the %command% part.

Note: To highlight this line in the installer box you need to make right-click on the window title bar. Choose Mark or Edit > Mark. Left-click & hold where you want to start, drag to select text, and release the button

  • In the Steam client, right-click on Stardew Valley and choose Properties:
  • Click General > Set Launch Options:
  • Replace anything in the textbox with the text you copied from the installer.(To paste text, click in the box and press CTRL and V.)
  • Click OK to save your changes.
  • From now on, just launch the game through Steam to run SMAPI with the Steam overlay and achievements.

Uninstall

  1. Run install.exe and choose uninstall.
  2. Blank the Steam launch options (if you changed them).
    If you want to play without mods temporarily, you can just launch Stardew Valley.exe directly instead.

Update

Method 1 (Using ModDrop)

If you use the ModDrop mod manager, click Update Available in the top-right if it appears and follow the on-screen instructions.

Method 2 (Using SMAPI’s installer )

Just install the new version; the installer will automatically clean up previous versions. (You don’t need to configure Steam again.)


SMAPI - Stardew Modding API
SMAPI - Stardew Modding API
SMAPI-2.11.2-installer.zip
Version: 2.11.2
1.9 MB
7 Downloads
Details...
(Visited 495 times, 11 visits today)
Related Posts

Leave a Comment