translators
8,411
edits
Changes
Modding:Migrate to Harmony 2.0 (view source)
Revision as of 18:49, 20 June 2020
, 18:49, 20 June 2020update: on hold due to Harmony 2.0 issues
←[[Modding:Index|Index]]
←[[Modding:Index|Index]]
<div style="border: 1px solid gray; border-left: 1em solid gray; padding: 0.5em 1em; border-radius: 5px;">
'''The following describes a future version of SMAPI, and may change before release.'''
</div>
'''This page is for modders. Players: see [[Modding:Mod compatibility]] instead.'''
'''This page is for modders. Players: see [[Modding:Mod compatibility]] instead.'''
* Various other improvements and fixes; see the [https://github.com/pardeike/Harmony/releases/tag/v2.0.0 Harmony 2.0 release notes] and [https://harmony.pardeike.net Harmony 2.0 documentation] for more info.
* Various other improvements and fixes; see the [https://github.com/pardeike/Harmony/releases/tag/v2.0.0 Harmony 2.0 release notes] and [https://harmony.pardeike.net Harmony 2.0 documentation] for more info.
After waiting ≈four months to make sure the release is stable, SMAPI 3.6 will transition to Harmony 2.0.
After waiting at least half a year to make sure the release is stable, SMAPI will transition to Harmony 2.0.
===Is this the modapocalypse?===
===Is this the modapocalypse?===
* most mods will be rewritten automatically for compatibility, so many mods will work without an update;
* most mods will be rewritten automatically for compatibility, so many mods will work without an update;
* pull requests will be submitted to update affected open-source mods;
* pull requests will be submitted to update affected open-source mods;
* unofficial updates will be created for mods which haven't updated officially by the time SMAPI 3.6 is released;
* unofficial updates will be created for mods which haven't updated officially by the time SMAPI migrates;
* the changes will be actively communicated and documented to modders.
* the changes will be actively communicated and documented to modders.
In addition, the current target is ''at least'' 90% compatibility for open-source mods before SMAPI 3.6 is released. All of this means that the 3.6 release should have minimal impact on mod compatibility, despite the scope of the changes.
In addition, the current target is ''at least'' 90% compatibility for open-source mods before SMAPI migrates. All of this means that the release should have minimal impact on mod compatibility, despite the scope of the changes.
===How to update your mod===
===How to update your mod===