Changes

[[Tools]] are items that can be swung or used by the player to perform some effect (e.g. dig dirt, chop trees, etc).

[[Tools]] are items that can be swung or used by the player to perform some effect (e.g. dig dirt, chop trees, etc).

They have their in-game sprites in <samp>TileSheets/Tools</samp>, and their code in <samp>StardewValley.Tool</samp> and various subclasses like <samp>StardewValley.Tools.Axe</samp>.

They have their data in <samp>Data/Tools</samp>, their in-game sprites in <samp>TileSheets/Tools</samp>, and their code in <samp>StardewValley.Tool</samp> and various subclasses like <samp>StardewValley.Tools.Axe</samp>.

===Data format===

===Data format===

You can now create/edit [[tools]] by editing the new <samp>Data/Tools</samp> asset. This consists of a string → model lookup, where...

You can create/edit [[tools]] by editing the<samp>Data/Tools</samp> asset. This consists of a string → model lookup, where...

* The key is the unqualified [[#Custom items|item ID]].

* The key is the unqualified [[Modding:Common_data_field_types#Item_ID|item ID]].

* The value is a model with the fields listed below.

* The value is a model with the fields listed below.

|-

|-

| <samp>CustomFields</samp>

| <samp>CustomFields</samp>

| The [[#Custom data fields|custom fields]] for this entry.

| The [[Modding:Common_data_field_types#Custom_fields|custom fields]] for this entry.

|}

|}

====Appearance====

====Appearance====

Note that drawing the tool correctly in the world (ie, while the player is trying to use it) probably still needs custom code.

Note that drawing the tool correctly in the world (ie, while the player is trying to use it) will likely require custom code.

{| class="wikitable"

{| class="wikitable"

|-

|-

| <samp>RequireToolId</samp>

| <samp>RequireToolId</samp>

| ''(Optional)'' If set, the [[#Custom items|qualified or unqualified item ID]] for the tool that must be in the player's inventory for the upgrade to appear. The tool will be destroyed when the upgrade is purchased.

| ''(Optional)'' If set, the [[Modding:Common_data_field_types#Item_ID|qualified or unqualified item ID]] for the tool that must be in the player's inventory for the upgrade to appear. The tool will be destroyed when the upgrade is purchased.

|-

|-

| <samp>TradeItemId</samp>

| <samp>TradeItemId</samp>

| ''(Optional)'' If set, the [[#Custom items|qualified or unqualified item ID]] for an extra item that must be traded to upgrade the tool. (For example, many vanilla tools need metal bars.)

| ''(Optional)'' If set, the [[Modding:Common_data_field_types#Item_ID|qualified or unqualified item ID]] for an extra item that must be traded to upgrade the tool. (For example, many vanilla tools need metal bars.)

|-

|-

| <samp>TradeItemAmount</samp>

| <samp>TradeItemAmount</samp>

</syntaxhighlight>

</syntaxhighlight>

Note that Clint needs a few days to smith the new tool. If you want to sell the tool directly, [[#Custom shops|add it to a regular shop]] instead.

Note that Clint needs a few days to smith the new tool. If you want to sell the tool directly, [[Modding:Shops|add it to a regular shop]] instead.

|}

|}