Modding:Index

A Mod is a package of files that changes the game Stardew Valley in some way. A Mod can add features (like showing NPCs on the map), change game mechanics (like making fences decay more slowly), make cosmetic changes (like making your house look like a hobbit home), and much more.

Main guides

Using mods How to install SMAPI, use mods, and troubleshoot them. Includes the compatibility list.

Creating SMAPI mods How to create SMAPI mods, with tutorials and documentation. This includes the full SMAPI API + event reference.

Translating mods How to contribute mod translations for any language supported by the game. (And for modders, how to enable and request translations.)

Search

Looking for something specific? Try searching the Modding namespace.

Advanced topics

For players

• Using XNB mods (not recommended)
• Modding on Android

For mod creators

• Common tasks (SMAPI mods)
• Open source
• Editing XNB files
• IDE reference
• NPCs:
  • Overview
  • Dialogue
  • Events
  • Gift tastes
  • Schedules

• Objects:
  • Craftable items
  • Crops
  • Furniture
  • Hats
  • Objects

• Other:
  • Animals
  • Achievements
  • Blueprints
  • Bundles
  • Debug commands
  • Farmer sprite
  • Fish
  • Maps
  • Monster data
  • Weather

Migration guides

These pages explain how to update your mod code for...

release	date released
SMAPI 2.0	October 2017
Stardew Valley 1.3	May 2018
Stardew Valley 1.3 (XNB changes)	May 2018
Stardew Valley 1.3.36	March 2019
Stardew Valley 1.4	TBD
SMAPI 3.0	TBD

See also

• Chat on Discord — get help, ask questions, or discuss with modders and SMAPI developers.