Difference between revisions of "Modding:Mod compatibility"

From Stardew Valley Wiki
Jump to navigation Jump to search
(→‎SMAPI mods: + alternate name for Shed Notifications)
(→‎SMAPI mods: update my mods)
Line 2,767: Line 2,767:
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/257
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/257
 
   |source  = https://github.com/VIspReaderUS/AccessChestAnywhere
 
   |source  = https://github.com/VIspReaderUS/AccessChestAnywhere
   |status  = broken
+
   |status  = workaround
   |summary  = <s>use [https://www.nexusmods.com/stardewvalley/mods/518 Chests Anywhere] instead</s>.
+
   |summary  = use [https://www.nexusmods.com/stardewvalley/mods/518 Chests Anywhere] instead.
 
   |broke in = Stardew Valley 1.1
 
   |broke in = Stardew Valley 1.1
 
}}
 
}}
Line 2,979: Line 2,979:
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/1063
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/1063
 
   |source  = https://github.com/Pathoschild/StardewMods
 
   |source  = https://github.com/Pathoschild/StardewMods
   |status  = broken
+
   |status  = ok
   |summary  =  
+
   |summary  = use alpha download.
  |broke in = Stardew Valley 1.3
 
 
}}
 
}}
 
{{/entry
 
{{/entry
Line 3,285: Line 3,284:
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/242
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/242
 
   |source  = https://gitlab.com/speeder1/ChestNameWithHoverLabel
 
   |source  = https://gitlab.com/speeder1/ChestNameWithHoverLabel
   |status  = broken
+
   |status  = workaround
   |summary  = <s>use [https://www.nexusmods.com/stardewvalley/mods/518 Chests Anywhere] instead.</s>
+
   |summary  = use [[#Chests_Anywhere|Chests Anywhere]] instead.
 
   |links    = https://gitlab.com/marianomdq/ChestNameWithHoverLabel/merge_requests/2
 
   |links    = https://gitlab.com/marianomdq/ChestNameWithHoverLabel/merge_requests/2
 
   |broke in = Stardew Valley 1.1
 
   |broke in = Stardew Valley 1.1
Line 3,295: Line 3,294:
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/701
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/701
 
   |source  =  
 
   |source  =  
   |status  = broken
+
   |status  = workaround
   |summary  = <s>use [https://www.nexusmods.com/stardewvalley/mods/518 Chests Anywhere] instead.</s>
+
   |summary  = use [[#Chests_Anywhere|Chests Anywhere]] instead.
 
   |broke in = SMAPI 2.0
 
   |broke in = SMAPI 2.0
 
}}
 
}}
Line 3,313: Line 3,312:
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/518
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/518
 
   |source  = https://github.com/Pathoschild/StardewMods
 
   |source  = https://github.com/Pathoschild/StardewMods
   |status  = broken
+
   |status  = ok
   |summary  =  
+
   |summary  = use alpha download.
  |broke in = Stardew Valley 1.3
 
 
}}
 
}}
 
{{/entry
 
{{/entry
Line 3,356: Line 3,354:
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/211
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/211
 
   |source  = https://github.com/CJBok/SDV-Mods
 
   |source  = https://github.com/CJBok/SDV-Mods
   |status  = broken
+
   |status  = workaround
   |summary  = <s>use [https://www.nexusmods.com/stardewvalley/mods/1063 Automate] instead</s>.
+
   |summary  = use [[#Automate|Automate]] instead.
 
   |broke in = Stardew Valley 1.2
 
   |broke in = Stardew Valley 1.2
 
}}
 
}}
Line 3,531: Line 3,529:
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/1915
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/1915
 
   |source  = https://github.com/pathoschild/StardewMods
 
   |source  = https://github.com/pathoschild/StardewMods
   |status  = broken
+
   |status  = ok
   |summary  =  
+
   |summary  = use alpha download.
  |broke in = Stardew Valley 1.3
 
 
}}
 
}}
 
{{/entry
 
{{/entry
Line 3,764: Line 3,761:
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/1691
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/1691
 
   |source  = https://github.com/Pathoschild/StardewMods
 
   |source  = https://github.com/Pathoschild/StardewMods
   |status  = broken
+
   |status  = ok
   |summary  =  
+
   |summary  = use alpha download.
  |broke in = Stardew Valley 1.3
 
 
}}
 
}}
 
{{/entry
 
{{/entry
Line 3,773: Line 3,769:
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/679
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/679
 
   |source  = https://github.com/Pathoschild/StardewMods
 
   |source  = https://github.com/Pathoschild/StardewMods
   |status  = broken
+
   |status  = ok
   |summary  =  
+
   |summary  = use alpha download.
  |broke in = Stardew Valley 1.3
 
 
}}
 
}}
 
{{/entry
 
{{/entry
Line 4,023: Line 4,018:
 
   |url      = https://community.playstarbound.com/threads/111931
 
   |url      = https://community.playstarbound.com/threads/111931
 
   |source  = https://github.com/oranisagu/SDV-FarmAutomation
 
   |source  = https://github.com/oranisagu/SDV-FarmAutomation
   |status  = broken
+
   |status  = workaround
   |summary  = <s>use [https://www.nexusmods.com/stardewvalley/mods/1063 Automate] instead</s>.
+
   |summary  = use [[#Automate|Automate]] instead.
 
   |broke in = Stardew Valley 1.2
 
   |broke in = Stardew Valley 1.2
 
}}
 
}}
Line 4,032: Line 4,027:
 
   |url      = https://community.playstarbound.com/threads/125172
 
   |url      = https://community.playstarbound.com/threads/125172
 
   |source  = https://github.com/maduin81/FarmAutomation_Unofficial
 
   |source  = https://github.com/maduin81/FarmAutomation_Unofficial
   |status  = broken
+
   |status  = workaround
   |summary  = <s>use [https://www.nexusmods.com/stardewvalley/mods/1063 Automate] instead</s>.
+
   |summary  = use [[#Automate|Automate]] instead.
 
   |broke in = SMAPI 2.0
 
   |broke in = SMAPI 2.0
 
}}
 
}}
Line 4,059: Line 4,054:
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/1089
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/1089
 
   |source  = https://github.com/Pathoschild/StardewMods
 
   |source  = https://github.com/Pathoschild/StardewMods
   |status  = broken
+
   |status  = ok
   |summary  =  
+
   |summary  = use alpha download.
  |broke in = Stardew Valley 1.3
 
 
}}
 
}}
 
{{/entry
 
{{/entry
Line 4,094: Line 4,088:
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/750
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/750
 
   |source  =  
 
   |source  =  
   |status  = broken
+
   |status  = workaround
   |summary  = <s>use [https://www.nexusmods.com/stardewvalley/mods/1089 Fast Animations] instead</s>.
+
   |summary  = use [[#Fast_Animations|Fast Animations]] instead.
 
   |broke in = Stardew Valley 1.2
 
   |broke in = Stardew Valley 1.2
 
}}
 
}}
Line 4,474: Line 4,468:
 
   |url      = https://community.playstarbound.com/threads/109038
 
   |url      = https://community.playstarbound.com/threads/109038
 
   |source  =  
 
   |source  =  
   |status  = broken
+
   |status  = workaround
   |summary  = <s>use [https://www.nexusmods.com/stardewvalley/mods/1089 Fast Animations] instead</s>.
+
   |summary  = use [[#Fast_Animations|Fast Animations]] instead.
 
   |broke in = Stardew Valley 1.1
 
   |broke in = Stardew Valley 1.1
 
}}
 
}}
Line 4,602: Line 4,596:
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/541
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/541
 
   |source  = https://github.com/Pathoschild/StardewMods
 
   |source  = https://github.com/Pathoschild/StardewMods
   |status  = broken
+
   |status  = ok
   |summary  =  
+
   |summary  = use alpha download.
  |broke in = Stardew Valley 1.3
 
 
}}
 
}}
 
{{/entry
 
{{/entry
Line 5,319: Line 5,312:
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/1100
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/1100
 
   |source  = https://github.com/Pathoschild/StardewMods
 
   |source  = https://github.com/Pathoschild/StardewMods
   |status  = broken
+
   |status  = ok
   |summary  =  
+
   |summary  = use alpha download.
  |broke in = Stardew Valley 1.3
 
 
}}
 
}}
 
{{/entry
 
{{/entry
Line 5,572: Line 5,564:
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/533
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/533
 
   |source  = https://github.com/Pathoschild/StardewMods
 
   |source  = https://github.com/Pathoschild/StardewMods
   |status  = broken
+
   |status  = ok
   |summary  =  
+
   |summary  = use alpha download.
  |broke in = Stardew Valley 1.3
 
 
}}
 
}}
 
{{/entry
 
{{/entry
Line 5,935: Line 5,926:
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/1369
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/1369
 
   |source  = https://github.com/pathoschild/StardewMods
 
   |source  = https://github.com/pathoschild/StardewMods
   |status  = broken
+
   |status  = ok
   |summary  =  
+
   |summary  = use alpha download.
  |broke in = Stardew Valley 1.3
 
 
}}
 
}}
 
{{/entry
 
{{/entry
Line 6,018: Line 6,008:
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/1401
 
   |url      = https://www.nexusmods.com/stardewvalley/mods/1401
 
   |source  = https://github.com/Pathoschild/StardewMods
 
   |source  = https://github.com/Pathoschild/StardewMods
   |status  = broken
+
   |status  = ok
   |summary  =  
+
   |summary  = use alpha download.
  |broke in = Stardew Valley 1.3
 
 
}}
 
}}
 
{{/entry
 
{{/entry

Revision as of 05:04, 25 April 2018

Index

SMAPI mod compatibility, July 2017 to April 2018. The two main events are Stardew Valley 1.2 in July 2017, and Stardew Valley 1.3 in April 2018.

Sometimes a SMAPI mod will stop working due to a game update or major SMAPI release (e.g. SMAPI 2.0 or 3.0). SMAPI automatically disables incompatible mods. This page lists known SMAPI mods and their compatibility status for the latest versions of Stardew Valley and SMAPI.

For players (Stardew Valley 1.2)

What to do

  1. For each mod you have installed, follow the instructions in the list below. If it's not listed, try updating to its latest version.
  2. If a mod is still failing, post a message in the SMAPI 2.0 migration thread (with your SMAPI log attached) and we'll help.

SMAPI mods

Here's a list of mods tested with SMAPI 2.5+ and Stardew Valley 1.2.30+. Content packs aren't listed unless incompatible. It's updated periodically for new mod releases.

  1. This only shows whether a mod is compatible; it may have bugs unrelated to SMAPI compatibility.

For players (Stardew Valley 1.3 beta)

What to do

  1. For each mod you have installed, follow the instructions in the list below. If it's not listed, try updating to its latest version.
  2. If a mod is still failing, post a message in the coordination thread (with your SMAPI log attached) and we'll help.

SMAPI mods

Here's a list of mods tested with SMAPI 2.6+ and Stardew Valley 1.3+. Content packs aren't listed unless incompatible. It's updated periodically for new mod releases.

This list doesn't include all known mods yet.

  1. This only shows whether a mod is compatible; it may have bugs unrelated to SMAPI compatibility.

For mod developers

Updating a mod

See migration guides. You can...

Creating an unofficial update

To avoid conflicting with official updates, here's the recommended way to create an unofficial update. This assumes you're creating a basic update (not a continuation or reinvention), and the code is on GitHub (adjust the steps accordingly if it's elsewhere).

  1. Fork the code.
  2. Make your changes to that fork (see #updating a mod).
  3. Increase the version in manifest.json by 0.0.1-<yourname>-update.
    For example, if the current version is 1.0.0 and your username is SampleUser, you'd change the version to 1.0.1-sampleUser-update. If you need to release new versions of your update, add a number at the end like 1.0.1-sampleUser-update.2, 1.0.1-sampleUser-update.3, etc. This ensures that official versions will supersede unofficial ones (e.g. for update checks).
  4. Push your changes to GitHub.
  5. Post a release package to the coordination thread with a link to your fork on GitHub.
    (If the mod uses the NuGet build package, there should be a release package named <mod name> <version>.zip in your bin folder.)
  6. Submit a pull request to the original author (if applicable).

Overall compatibility

For Stardew Valley 1.2
 
94% are compatible or have a working alternative.
 
1% have an update coming soon.
 
5% are broken and not open-source.¹
¹ Many of these broke due to a Stardew Valley update. Some may be updated by their authors later.
For Stardew Valley 1.3
 
15% are compatible or have a working alternative.
 
56% have an update coming soon.
 
30% are broken and not open-source.¹
¹ Many of these broke due to a Stardew Valley update. Some may be updated by their authors later.