SMAPI Stardew Valley

by Pathoschild·v4.5.2·Updated 2026-07-08

SMAPI星露谷物语

Screenshots 2 screenshots

About this mod Machine translation

SMAPI is the mod loader for Stardew Valley. It runs well on GOG and Steam achievements, is compatible with Linux/macOS/Windows, and can be uninstalled at any time. Most Stardew Valley mods require SMAPI to use. If you need help, there's a friendly community here. SMAPI is required for most types of Stardew Valley mods.

Install SMAPI

Before installing, run the game at least once

Download the latest SMAPI

Unzip the downloaded compressed package to any location

Double-click to run install on Windows.bat,

Install according to the prompts

Detailed documentation Modding:Player_Guide (EN)

Get help

See mods on the wiki:Help!

Install & use Install: SMAPI mod (Stardew Valley standard)

  1. Install SMAPI first (Stardew Valley's mod loader): download it from smapi.io, run 'install on Windows.bat' and pick your game folder.
  2. Unzip the archive from playbuff and find the folder that contains manifest.json — that folder is the mod.
  3. Copy that whole folder into Stardew Valley/Mods/.
  4. Launch the game through SMAPI (run StardewModdingAPI.exe or set it as the launch option). The console before the title screen lists each mod's load result.

Cheat-style tools may not need SMAPI — unzip and run them as the readme describes. Back up your save before editing it; SMAPI lists failed mods in its console.

File & checksum

Filename
SMAPI 4.5.2 4.5.2.zip
File size
39.9 MiB