Line 1: |
Line 1: |
| {{modding player guide header}} | | {{modding player guide header}} |
− | [[File:SMAPI compatibility.png|thumb|SMAPI mod compatibility, July 2017 to March 2021. See [[:File:SMAPI compatibility.png#Notable events|notable events which affect this chart]].<br /> | + | [[File:SMAPI compatibility.png|thumb|SMAPI mod compatibility, July 2017 to June 2024. See [[:File:SMAPI compatibility.png#Notable events|notable events which affect this chart]].<br /> |
| <span style="background: #cc0000;"> </span> broken (proprietary)<br /> | | <span style="background: #cc0000;"> </span> broken (proprietary)<br /> |
| <span style="background: #e69138;"> </span> broken (open-source)<br /> | | <span style="background: #e69138;"> </span> broken (open-source)<br /> |
Line 7: |
Line 7: |
| 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. | | 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. |
| | | |
| + | ==Instructions== |
| + | ===For players=== |
| + | '''See [https://smapi.io/mods smapi.io/mods] for a more user-friendly view of this page.''' |
| | | |
| + | To update your mods: |
| + | # For each mod you have installed, follow the instructions in the list below. If it's not listed, try updating to its latest version. |
| + | # If a mod is still failing, post a message in the [https://forums.stardewvalley.net/threads/unofficial-mod-updates.2096/ coordination thread] (with [[Modding:Player Guide/Troubleshooting#The basics|your SMAPI log]] attached) and we'll help. |
| | | |
− | '''Players: see [https://smapi.io/mods smapi.io/mods] for a more user-friendly view of this page.'''
| + | ===For mod authors=== |
| + | Feel free to update the lists below! See [[Modding:Mod compatibility/entry#Usage|instructions for editing the template]]. |
| | | |
− | ==For players==
| + | Notes for the mod status: |
− | ===What to do===
| + | * Only mark a mod <samp>abandoned</samp> or <samp>obsolete</samp> if (a) the mod author has explicitly abandoned the mod, or (b) they've hidden or deleted the mod page, or (c) it's been superseded by an equivalent game feature. A mod is not considered abandoned just because it hasn't been updated for a while. |
− | # For each mod you have installed, follow the instructions in the list below. If it's not listed, try updating to its latest version.
| + | * Only mark a mod <samp>broken</samp> if it's ''incompatible''. This isn't the place to track general mod bugs, unless they impact compatibility. In rare cases where a non-compatibility bug is severe enough to note here (e.g. game crashes on some platforms), you can use the <samp>warnings</samp> field. |
− | # If a mod is still failing, post a message in the [https://forums.stardewvalley.net/threads/unofficial-mod-updates.2096/ coordination thread] (with [[Modding:Player Guide/Troubleshooting#The basics|your SMAPI log]] attached) and we'll help.
| |
| | | |
| + | ==Compatibility list== |
| ===C# mods=== | | ===C# mods=== |
| + | This includes every known C# SMAPI mod. It's updated for new/updated mods on CurseForge/ModDrop/Nexus periodically with the help of {{github|Pathoschild/StardewScripts/tree/main/mod-dump|semi-automated scripts}}, but feel free to make corrections as needed! |
| + | |
| <!-- | | <!-- |
| | | |
Line 24: |
Line 33: |
| | | |
| --> | | --> |
− | * '''Players:''' See [https://smapi.io/mods smapi.io/mods] for a more user-friendly list.
| |
− | * '''Modders:''' feel free to update this list! (See [[Modding:Mod compatibility/entry#Usage|instructions]].) Note that only SMAPI mods should be listed, not [[Modding:Using XNB mods|XNB mods]] or content packs.
| |
− |
| |
| {{#invoke:SMAPI compatibility|header}} | | {{#invoke:SMAPI compatibility|header}} |
| {{#invoke:SMAPI compatibility|entry | | {{#invoke:SMAPI compatibility|entry |
Line 23,649: |
Line 23,655: |
| ===XNB mods=== | | ===XNB mods=== |
| See [[Modding:Using XNB mods]]. | | See [[Modding:Using XNB mods]]. |
| + | <!-- |
| + | |
| + | Do not list XNB mods here. |
| + | |
| + | --> |
| | | |
| ==Mod data overrides== | | ==Mod data overrides== |