Unofficial updates fix mod compatibility when the author is away. This thread lets you download and request them.
For players
How do I find the latest update?
How do I get help with a broken mod with no unofficial update?
If that doesn't work, and the mod is incompatible and hasn't been updated in a long time and the author isn't responding to comments on the mod page, post a message in this thread and we'll help. Make sure to attach your
SMAPI log after trying the mod.
What mod types does this thread cover?
For mod authors
How do I create an unofficial update?
Unofficial updates use a special version format, to avoid breaking update alerts for official updates. See
create an unofficial update on the wiki for more info.
To share an unofficial update, post a comment here with...
- the mod name, with a link to the official mod page;
- a list of changes you made;
- a link to the pull request where you submitted the changes to the original author (recommended);
- the unofficial update as a .zip file (avoid .rar or .7z for best compatibility).
Can I update a closed-source or proprietary mod?
No, only
open-source mods should be updated unofficially. If you post an unofficial update for a closed-source or proprietary mod, you're violating the original author's copyright on their work. You can contact the author and suggest making their mod open-source instead (and link them to
open source on the wiki for more info).
What if the mod author is still active?
- To fix a bug: submit a pull request or report it on the mod page instead. Unofficial updates for active compatible mods won't be listed on the mod compatibility list, so most players won't find them.
- To fix an incompatible mod: you can technically post an unofficial update for an actively-maintained mod, but it's considered rude and some mod authors will be annoyed if you do this. Consider contacting the mod author to ask if they plan to update the mod themselves first.
How do I update my own mods?
For a SMAPI mod, see
migration guides on the wiki. You can also check
smapi.io/mods to know if the mod worked as of the last check (the list is updated regularly).
For a content pack, ask the author of the framework mod that loads it (e.g. on the
Content Patcher page for a Content Patcher pack). Most content packs aren't affected by game updates once the parent mod updates.
(Continued from updating mods for Stardew Valley 1.4.)