Changes

====Define a custom item====

====Define a custom item====

:; Overview

<dl style="margin-left: 2em;">

:: You can define custom items for most vanilla item types using only [[Modding:Content Patcher|Content Patcher]] or [[Modding:Modder Guide/APIs/Content|SMAPI's content API]]. The data asset for each item type has two new fields:

<dt>Overview</dt>

:: {| class="wikitable"

You can define custom items for most vanilla item types using only [[Modding:Content Patcher|Content Patcher]] or [[Modding:Modder Guide/APIs/Content|SMAPI's content API]]. The data asset for each item type has two new fields:

{| class="wikitable"

|-

|-

! field

! field

|}

|}

:: Supported item types:

Supported item types:

:: {| class="wikitable"

{| class="wikitable"

|-

|-

! item type

! item type

|}

|}

:: For example, this content pack adds a new Pufferchick item with a custom image, custom gift tastes, and a custom crop that produces it. Note that item references in other data assets like <samp>Data/Crops</samp> and <samp>Data/NPCGiftTastes</samp> use the item ID.

For example, this content pack adds a new Pufferchick item with a custom image, custom gift tastes, and a custom crop that produces it. Note that item references in other data assets like <samp>Data/Crops</samp> and <samp>Data/NPCGiftTastes</samp> use the item ID.

:: {{#tag:syntaxhighlight|<nowiki>

{{#tag:syntaxhighlight|<nowiki>

{

{

     "Format": "</nowiki>{{Content Patcher version}}<nowiki>",

     "Format": "</nowiki>{{Content Patcher version}}<nowiki>",

}</nowiki>|lang=javascript}}

}</nowiki>|lang=javascript}}

:: Most item data assets work just like <samp>Data/ObjectInformation</samp>. For fruit trees, see [[#Custom fruit trees|custom fruit trees]].

Most item data assets work just like <samp>Data/ObjectInformation</samp>. For fruit trees, see [[#Custom fruit trees|custom fruit trees]].

:; Tools

<dt>Tools</dt>

:: Tools are defined in the new <samp>Data/ToolData</samp> asset using this field format:

Tools are defined in the new <samp>Data/ToolData</samp> asset using this field format:

:: {| class="wikitable"

{| class="wikitable"

|-

|-

! index

! index

| ''(Optional)'' The asset name for the item's spritesheet.

| ''(Optional)'' The asset name for the item's spritesheet.

|}

|}

:; Melee weapons

<dt>Melee weapons</dt>

:: Melee weapons are [[Modding:Items#Weapons|defined in <samp>Data/Weapons</samp>]] like before, but you can now add custom behavior by editing the <samp>Data/AdditionalWeaponProperties</samp> asset. This consists of a string → model lookup, where the key is the unqualified [[#Custom items|item ID]] and the value is a model with these fields:

Melee weapons are [[Modding:Items#Weapons|defined in <samp>Data/Weapons</samp>]] like before, but you can now add custom behavior by editing the <samp>Data/AdditionalWeaponProperties</samp> asset. This consists of a string → model lookup, where the key is the unqualified [[#Custom items|item ID]] and the value is a model with these fields:

:: {| class="wikitable"

{| class="wikitable"

|-

|-

! field

! field

| ''(Optional)'' '''Unused.'''

| ''(Optional)'' '''Unused.'''

|}

|}

====Error items====

====Error items====