Changes

===Is this the modapocalypse?===

===Is this the modapocalypse?===

Nope. Although this is a major change, significant effort will be undertaken to minimise the impact:

Nope. Although this is a major change, significant effort were undertaken to minimise the impact:

* the old events will be supported for a long time with increasingly prominent warnings in the SMAPI console about their deprecation and removal;

* the old events were supported for a long time with increasingly prominent warnings in the SMAPI console about their deprecation and removal;

* pull requests will be submitted to update affected open-source mods;

* pull requests were submitted to update affected open-source mods;

* unofficial updates will be created for mods which haven't updated officially by the time SMAPI 3.0 is released;

* unofficial updates were created for mods which haven't updated officially by the time SMAPI 3.0 is released;

* the changes will be actively communicated and documented to modders.

* the changes was actively communicated and documented to modders.

In addition, the current target is ''at least'' 95% compatibility for open-source mods before SMAPI 3.0 is released. All of this means that the 3.0 release should have minimal impact on mod compatibility, despite the scope of the changes.

In addition, the current target is ''at least'' 95% compatibility for open-source mods before SMAPI 3.0 is released. All of this means that the 3.0 release should have minimal impact on mod compatibility, despite the scope of the changes.

</source>

</source>

That code will fail in SMAPI 3.0, because no locations are loaded yet. This code could be rewritten like this:

That code fails in SMAPI 3.0, because no locations are loaded yet. This code could be rewritten like this:

<source lang="c#">

<source lang="c#">

public override void Entry(IModHelper helper)

public override void Entry(IModHelper helper)

===Event changes===

===Event changes===

The former events will be removed in SMAPI 3.0. Here's how to convert them to the new events under <tt>this.Helper.Events</tt>. This list only shows equivalent events in SMAPI 3.0; see [[Modding:Modder Guide/APIs/Events|''events'' in the modder guide]] for a full list.

The former events are removed in SMAPI 3.0. Here's how to convert them to the new events under <tt>this.Helper.Events</tt>. This list only shows equivalent events in SMAPI 3.0; see [[Modding:Modder Guide/APIs/Events|''events'' in the modder guide]] for a full list.

{| class="wikitable"

{| class="wikitable"