Changes

←[[Modding:Index|Index]]

←[[Modding:Index|Index]]

'''This page is for modders. Players: see [[Modding:SMAPI compatibility]] instead.'''

{{Modder compatibility header}}

 

This page explains how to update your mods for compatibility with Stardew Valley 1.3.

This page explains how to update your mods for compatibility with Stardew Valley 1.3.

__TOC__

__TOC__

==SMAPI mods==

==SMAPI mods==

Most SMAPI mods are unaffected. If your mod broke, you probably just need to recompile a new DLL and release it. (Don't forget to update the <tt>manifest.json</tt> version!)

Most SMAPI mods are unaffected. If your mod broke, you probably just need to recompile a new DLL and release it. (Don't forget to update the <samp>manifest.json</samp> version!)

==Content Patcher packs==

==Content Patcher packs==

===Custom map tilesheets===

===Custom map tilesheets===

If you use <tt>Action: Load</tt> to provide a custom tilesheet, make sure it's in the <tt>Maps</tt> folder. For example:

If you use <samp>Action: Load</samp> to provide a custom tilesheet for a map, make sure it's in the <samp>Maps</samp> folder. For example:

<source lang="javascript">

<syntaxhighlight lang="javascript">

// incorrect

// incorrect

"Target": "Tilesheet"

"Target": "Tilesheet"

// correct

// correct

"Target": "Maps/Tilesheet"

"Target": "Maps/Tilesheet"

</source>

</syntaxhighlight>

===Mine tilesheets===

===Mine tilesheets===

<pre>Microsoft.Xna.Framework.Content.ContentLoadException: Error loading "Maps\mine". File contains xTile.Map but trying to load as Microsoft.Xna.Framework.Graphics.Texture2D.</pre>

<pre>Microsoft.Xna.Framework.Content.ContentLoadException: Error loading "Maps\mine". File contains xTile.Map but trying to load as Microsoft.Xna.Framework.Graphics.Texture2D.</pre>

That happens because the <tt>Content/mine.xnb</tt> tilesheet was deleted in Stardew Valley 1.3.36, so the game is trying to load it from <tt>Content/Maps/mine.xnb</tt> map file instead.  

That happens because <samp>Content/mine.xnb</samp> (a tilesheet) was deleted in Stardew Valley 1.3.36, so the game is trying to load it from <samp>Content/Maps/mine.xnb</samp> (a map) instead.  

You need to change the tilesheet reference to fix it. (These instructions assume the map is in a <tt>assets</tt> subfolder inside the content pack.)

You need to change the tilesheet reference to fix it. (These instructions assume the map file is unpacked and in an <samp>assets</samp> subfolder inside the content pack.)

# If you already have a <tt>mine.png</tt> file in your content pack folder, delete it.

# If you already have a <samp>mine.png</samp> file in your content pack folder, delete it.

# [[Modding:Editing XNB files|Unpack <tt>Content/Maps/Mines/mine.xnb</tt>]].

# [[Modding:Editing XNB files|Unpack <samp>Content/Maps/Mines/mine.xnb</samp>]].

# Copy <tt>mine.png</tt> to <tt>assets/mine.png</tt> '''and''' <tt>assets/Mines/mine.png</tt>.

# Copy <samp>mine.png</samp> to <samp>assets/mine.png</samp> '''and''' <samp>assets/Mines/mine.png</samp>.

# Open the <tt>.tbin</tt> file in Tiled.

# Open the <samp>.tbin</samp> file in Tiled.

# In the 'Tilesets' pane, click the mine tilesheet's tab and click the edit icon at the bottom (which looks like a wrench). This should open the tilesheet in a separate tab.

# In the 'Tilesets' pane, click the mine tilesheet's tab and click the edit icon at the bottom (which looks like a wrench). This should open the tilesheet in a separate tab.

# At the top, click _Tileset > Tileset Properties_. This should open a 'Properties' pane.

# At the top, click ''Tileset > Tileset Properties''. This should open a 'Properties' pane.

# Click the 'image' field, click the 'edit' button that appears, and click 'browse' in the window that opens.

# Click the 'image' field, click the 'edit' button that appears, and click 'browse' in the window that opens.

# Select the <tt>assets/Mines/mine.png</tt> file.

# Select the <samp>assets/Mines/mine.png</samp> file.

# Save your changes to the map.

# Save your changes to the map.

# Delete the <tt>assets/mine.png</tt> file, which is no longer needed.

# Delete the <samp>assets/mine.png</samp> file, which is no longer needed.

That's it! Don't forget to delete <tt>Maps/mine.png</tt> from the content pack folder before releasing, so Content Patcher loads the one provided by the game.

That's it! Don't forget to delete <samp>assets/mine.png</samp> from the content pack folder before releasing (unless you customised it), so Content Patcher loads the one provided by the game.

[[Category:Modding]]

[[Category:Modding]]