Difference between revisions of "Modding:Mod compatibility"

From Stardew Valley Wiki
Jump to navigation Jump to search
(→‎SMAPI mods: add ModDrop IDs (Chest Displays, Multi-User Chests, Piggy Bank Mod))
(→‎SMAPI mods: new mods: Automate Chests, Avoid Losing Scepter, Better Crafting → Buildings, Better Return Scepter, Birthday Today, Buildable Greenhouse Updated, Bus Sprite Adjuster, Chess Boards, Crop Hat, Custom Trash Can, Dialogue Display Framework, Dreamscape, Easier Cave Puzzle, Fluent Eating, Fungus Amongus, Giant Crop Fertilizer, Harvest Seeds, Highlight Empty Machines, JhinFour, Leave the Mine, Linus Mod, Market Day, More Fertilizers, Partial Hearts, Planter Trees, Safe Lightning Redux)
Line 831: Line 831:
 
   |moddrop id = 509760
 
   |moddrop id = 509760
 
   |github  = Pathoschild/StardewMods
 
   |github  = Pathoschild/StardewMods
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Automate Chests
 +
  |author  = SinZ
 +
  |id      = SinZ.AutomateChests
 +
  |nexus id = 11727
 +
  |github  = SinZ163/StardewMods
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 937: Line 944:
 
   |unofficial version = 2.0.1-unofficial.1-strobe
 
   |unofficial version = 2.0.1-unofficial.1-strobe
 
   |unofficial url    = https://forums.stardewvalley.net/threads/unofficial-mod-updates.2096/page-65#post-44643
 
   |unofficial url    = https://forums.stardewvalley.net/threads/unofficial-mod-updates.2096/page-65#post-44643
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Avoid Losing Scepter
 +
  |author  = atravita
 +
  |id      = atravita.AvoidLosingScepter
 +
  |nexus id = 11856
 +
  |github  = atravita-mods/AvoidLosingSpecter
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 1,109: Line 1,123:
 
   |nexus id = 11115
 
   |nexus id = 11115
 
   |moddrop id = 1115749
 
   |moddrop id = 1115749
 +
  |github  = KhloeLeclair/StardewMods
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Better Crafting: Buildings, Craftable Buildings
 +
  |author  = Khloe Leclair
 +
  |id      = leclair.bcbuildings
 +
  |moddrop id = 1115749
 +
  |nexus id = 11115
 
   |github  = KhloeLeclair/StardewMods
 
   |github  = KhloeLeclair/StardewMods
 
}}
 
}}
Line 1,308: Line 1,330:
 
   |nexus id = 3232
 
   |nexus id = 3232
 
   |github  = AndyCrocker/StardewMods
 
   |github  = AndyCrocker/StardewMods
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Better Return Scepter
 +
  |author  = DecidedlyHuman
 +
  |id      = DecidedlyHuman.BetterReturnScepter
 +
  |nexus id = 11610
 +
  |github  = DecidedlyHuman/StardewValleyMods
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 1,476: Line 1,505:
 
   |github  = KathrynHazuka/StardewValley_BirthdayMail
 
   |github  = KathrynHazuka/StardewValley_BirthdayMail
 
   |dev note = author ignored previous PRs
 
   |dev note = author ignored previous PRs
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Birthday Today
 +
  |author  = ChiroxT
 +
  |id      = treinke.birthdaytoday
 +
  |nexus id = 11578
 +
  |github  =
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 1,622: Line 1,658:
 
   |nexus id = 445
 
   |nexus id = 445
 
   |github  = janavarro95/Stardew_Valley_Mods
 
   |github  = janavarro95/Stardew_Valley_Mods
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Buildable Greenhouse Updated
 +
  |author  = Yariazen
 +
  |id      = Yariazen.BuildableGreenhouse
 +
  |nexus id = 11831
 +
  |github  = Yariazen/BuildableGreenhouse
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 1,666: Line 1,709:
 
   |nexus id = 2905
 
   |nexus id = 2905
 
   |github  = hootless/StardewMods
 
   |github  = hootless/StardewMods
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Bus Sprite Adjuster, Ribeena's Vehicles
 +
  |author  = ribeena
 +
  |id      = ribeena.busspriteadjuster
 +
  |nexus id = 11809
 +
  |github  =
 +
  |source  = {{Nexus mod|11809}}<!--separate download-->
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 1,937: Line 1,988:
 
   |moddrop id = 793917
 
   |moddrop id = 793917
 
   |github  = Platonymous/Stardew-Valley-Mods
 
   |github  = Platonymous/Stardew-Valley-Mods
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Chess Boards
 +
  |author  = aedenthorn
 +
  |id      = aedenthorn.ChessBoards
 +
  |nexus id = 11580
 +
  |github  = aedenthorn/StardewValleyMods
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 2,560: Line 2,618:
 
   |nexus id = 7203
 
   |nexus id = 7203
 
   |github  = stoobinator/Stardew-Valley-Grace-Period
 
   |github  = stoobinator/Stardew-Valley-Grace-Period
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Crop Hat
 +
  |author  = aed, aedenthorn
 +
  |id      = aedenthorn.CropHat
 +
  |nexus id = 11787
 +
  |github  = aedenthorn/StardewValleyMods
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 3,043: Line 3,108:
 
   |github    = Esca-MMC/CustomTracker
 
   |github    = Esca-MMC/CustomTracker
 
   |moddrop id = 706059
 
   |moddrop id = 706059
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Custom Trash Can
 +
  |author  = ShivaGuy
 +
  |id      = ShivaGuy.CustomTrashCan
 +
  |nexus id = 11835
 +
  |github  = ShivaGuy/StardewMods
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 3,324: Line 3,396:
 
   |nexus id = 8853
 
   |nexus id = 8853
 
   |github  = gzhynko/StardewMods
 
   |github  = gzhynko/StardewMods
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Dialogue Display Framework
 +
  |author  = aedenthorn
 +
  |id      = aedenthorn.DialogueDisplayFramework
 +
  |nexus id = 11661
 +
  |github  = aedenthorn/StardewValleyMods
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 3,465: Line 3,544:
 
   |moddrop id = 1125248
 
   |moddrop id = 1125248
 
   |github  = atravita-mods/DrawFishPondsOverGrass
 
   |github  = atravita-mods/DrawFishPondsOverGrass
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Dreamscape
 +
  |author  = aedenthorn
 +
  |id      = aedenthorn.Dreamscape
 +
  |nexus id = 11742
 +
  |github  = aedenthorn/StardewValleyMods
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 3,593: Line 3,679:
 
   |nexus id = 8450
 
   |nexus id = 8450
 
   |github  = dtomlinson-ga/EarlyCommunityUpgrades
 
   |github  = dtomlinson-ga/EarlyCommunityUpgrades
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Easier Cave Puzzle
 +
  |author  = atravita
 +
  |id      = atravita.NerfCavePuzzle
 +
  |moddrop id = 1131424
 +
  |nexus id = 11500
 +
  |github  = atravita-mods/NerfCavePuzzle
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 4,716: Line 4,810:
 
   |nexus id = 9043
 
   |nexus id = 9043
 
   |github  = aedenthorn/StardewValleyMods
 
   |github  = aedenthorn/StardewValleyMods
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Fluent Eating
 +
  |author  = Kangzoel
 +
  |id      = Kangzoel.FluentEating
 +
  |nexus id = 11690
 +
  |github  =
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 4,877: Line 4,978:
 
   |nexus id = 11422
 
   |nexus id = 11422
 
   |github  = aedenthorn/StardewValleyMods
 
   |github  = aedenthorn/StardewValleyMods
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Fungus Amongus
 +
  |author  = Okay Shroomer
 +
  |id      = OkayShroomer.FungusAmongus
 +
  |nexus id = 11785
 +
  |github  =
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 5,015: Line 5,123:
 
   |moddrop id = 793902
 
   |moddrop id = 793902
 
   |github  = Platonymous/Stardew-Valley-Mods
 
   |github  = Platonymous/Stardew-Valley-Mods
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Giant Crop Fertilizer
 +
  |author  = atravita
 +
  |id      = atravita.GiantCropFertilizer
 +
  |moddrop id = 1135913
 +
  |nexus id = 11620
 +
  |github  = atravita-mods/GiantCropFertilizer
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 5,337: Line 5,453:
 
   |nexus id = 1157
 
   |nexus id = 1157
 
   |github  = Sasara2201/WitchPrincess
 
   |github  = Sasara2201/WitchPrincess
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Harvest Seeds
 +
  |author  = aedenthorn
 +
  |id      = aedenthorn.HarvestSeeds
 +
  |nexus id = 11773
 +
  |github  = aedenthorn/StardewValleyMods
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 5,471: Line 5,594:
 
   |nexus id = 11421
 
   |nexus id = 11421
 
   |github  = Shockah/Stardew-Valley-Mods
 
   |github  = Shockah/Stardew-Valley-Mods
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Highlight Empty Machines
 +
  |author  = atravita
 +
  |id      = atravita.HighlightEmptyMachines
 +
  |moddrop id = 1137391
 +
  |nexus id = 11664
 +
  |github  = atravita-mods/HighlightEmptyMachines
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 6,051: Line 6,182:
 
   |nexus id = 5292
 
   |nexus id = 5292
 
   |moddrop id = 988956
 
   |moddrop id = 988956
 +
  |github  =
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = JhinFour
 +
  |author  = Keaton Sadoski
 +
  |id      = Sadoski.JhinFour
 +
  |nexus id = 11838
 
   |github  =
 
   |github  =
 
}}
 
}}
Line 6,284: Line 6,422:
 
   |nexus id = 7917
 
   |nexus id = 7917
 
   |github  = dmcrider/LastDayToPlant
 
   |github  = dmcrider/LastDayToPlant
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Leave the Mine
 +
  |author  = Kangzoel
 +
  |id      = Kangzoel.LeaveTheMine
 +
  |nexus id = 11823
 +
  |github  =
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 6,366: Line 6,511:
 
   |unofficial version = 1.2.2-unofficial.1-bigboct
 
   |unofficial version = 1.2.2-unofficial.1-bigboct
 
   |unofficial url    = https://forums.stardewvalley.net/threads/unofficial-mod-updates.2096/page-14#post-21916
 
   |unofficial url    = https://forums.stardewvalley.net/threads/unofficial-mod-updates.2096/page-14#post-21916
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Linus Mod
 +
  |author  = tomii
 +
  |id      = tomii.LinusMod
 +
  |nexus id = 11637
 +
  |github  =
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 6,719: Line 6,871:
 
   |nexus id = 10758
 
   |nexus id = 10758
 
   |github  = Goldenrevolver/Stardew-Valley-Mods
 
   |github  = Goldenrevolver/Stardew-Valley-Mods
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Market Day
 +
  |author  = ceruleandeep
 +
  |id      = ceruleandeep.MarketDay
 +
  |nexus id = 11778
 +
  |github  = ChroniclerCherry/stardew-valley-mods
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 7,117: Line 7,276:
 
   |nexus id = 10008
 
   |nexus id = 10008
 
   |github  = elizabethcd/MoreConversationTopics
 
   |github  = elizabethcd/MoreConversationTopics
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = More Fertilizers
 +
  |author  = atravita, Atravita
 +
  |id      = atravita.MoreFertilizers
 +
  |moddrop id = 1145236
 +
  |nexus id = 11837
 +
  |github  = atravita-mods/MoreFertilizers
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 7,996: Line 8,163:
 
   |nexus id = 3524
 
   |nexus id = 3524
 
   |github  =  
 
   |github  =  
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Partial Hearts
 +
  |author  = aedenthorn
 +
  |id      = aedenthorn.PartialHearts
 +
  |nexus id = 11628
 +
  |github  = aedenthorn/StardewValleyMods
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry
Line 8,311: Line 8,485:
 
   |id      = aedenthorn.PlantAll
 
   |id      = aedenthorn.PlantAll
 
   |nexus id = 10482
 
   |nexus id = 10482
 +
  |github  = aedenthorn/StardewValleyMods
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Planter Trees
 +
  |author  = aedenthorn
 +
  |id      = aedenthorn.PlanterTrees
 +
  |nexus id = 11687
 
   |github  = aedenthorn/StardewValleyMods
 
   |github  = aedenthorn/StardewValleyMods
 
}}
 
}}
Line 9,426: Line 9,607:
 
   |unofficial version = 2.1.1-unofficial.1-strobe
 
   |unofficial version = 2.1.1-unofficial.1-strobe
 
   |pull request      = https://github.com/danvolchek/StardewMods/pull/22
 
   |pull request      = https://github.com/danvolchek/StardewMods/pull/22
 +
}}
 +
{{#invoke:SMAPI compatibility|entry
 +
  |name    = Safe Lightning Redux, Safe Lightning
 +
  |author  = Shockah
 +
  |id      = Shockah.SafeLightning
 +
  |nexus id = 11857
 +
  |github  = Shockah/Stardew-Valley-Mods
 
}}
 
}}
 
{{#invoke:SMAPI compatibility|entry
 
{{#invoke:SMAPI compatibility|entry

Revision as of 19:54, 30 April 2022

Modding:Player Guide/header

SMAPI mod compatibility, July 2017 to present. See notable events which affect this chart.
broken (proprietary)
broken (open-source)
compatible

Sometimes a mod will stop working due to a major game update; SMAPI automatically disables incompatible mods. This page lists known SMAPI mods and their compatibility with the latest versions, and explains how to fix broken mods if possible.



Players: see smapi.io/mods for a more user-friendly view of this page.

For players

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

  • Players: See smapi.io/mods for a more user-friendly list.
  • Modders: feel free to update this list! (See instructions.) Note that only SMAPI mods should be listed, not XNB mods or content packs.

SMAPI mods (obsolete)

This list contains mods which...

  • have their mod pages hidden/deleted;
  • or have been replaced by a change in the base game;
  • or have been explicitly abandoned by the mod author (unless they're open-source and likely to be updated unofficially).

These will likely never be updated again.

Content packs

This list shows broken content packs for SMAPI mods like Content Patcher. Only incompatible content packs are listed; working content packs are not listed (even if they have non-compatibility bugs). For legacy XNB mods, see #XNB mods.

XNB mods

See Modding:Using XNB mods.

Mod data overrides

This section overrides the data specified in mods' manifest.json files or mod pages for SMAPI's update checks. This is a specialized section; in most cases it's better to correct the mod instead. See the format description when editing this section.

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. Change the version in manifest.json to the official version number plus 0.0.1, with -unofficial.1-yourName at the end.
    For example, if the current version is 1.0.0 and your name is SampleUser, change it to 1.0.1-unofficial.1-sampleUser. If you need to release a new unofficial update, just increment unofficial.1 to unofficial.2, etc. This ensures that official versions supersede unofficial ones (e.g., for update checks), and other users can release newer unofficial updates if needed.
  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).