Modding:Index

Mods are packages of files which change Stardew Valley in some way. Mods 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.

Using mods

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

• Get help or ask question
• Join the community
• Using XNB mods (not recommended)

Creating mods

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

Creating content packs How to create content packs for frameworks like Content Patcher.

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

• Looking for something specific? Try searching the Modding namespace.
• Get help or ask question
• Join the community
• Open source

Advanced topics

• SMAPI API reference (also on the sidebar in the "Creating SMAPI mods" guide above)
• Modding tutorials wiki
• Common tasks (SMAPI mods)
• Specific Examples (SMAPI mods)
• Editing XNB files
• IDE reference

• NPCs:
  • Overview
  • Dialogue
  • Events
  • Gift tastes
  • Quests
  • Schedules

• Object data:
  • Craftable items
  • Crops
  • Furniture
  • Hats
  • Objects
  • Weapons

• Object metadata:
  • Context tags

• Other:
  • Animals
  • Achievements
  • Blueprints
  • Bundles
  • Debug commands
  • Farmer sprite
  • Festivals
  • Fish
  • Fish Ponds
  • Locations
  • Maps
  • Mail
  • Monsters
  • Recipes
  • Special orders
  • Weather

Migration guides

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	November 2019
SMAPI 3.0	November 2019
Stardew Valley 1.5	December 2020
64-bit on Windows	May 2021
Harmony 2.0	July 2021
Stardew Valley 1.5.5	August 2021

See also

• User:Kdau#Notes on Android SMAPI modding
• Check out the Stardew Valley art style guide some modders created.
• rhubarb#4755 on Discord wrote a few tips specific to hair for portraits.
• Airyn#8682 on Discord recommends this pixel art tutorial on Pixel Joint and this pixel art guide on Medium.