Modding:Hats - Revision history

imported>VulpesLucida: zh link

2024-12-28T07:55:09Z

zh link

← Older revision		Revision as of 07:55, 28 December 2024
Line 60:		Line 60:

	[[Category:Modding]]		[[Category:Modding]]

			[[zh:模组:帽子]]

imported>Pathoschild: /* Overview */ add item type info

2024-12-16T01:05:44Z

Overview: add item type info

← Older revision		Revision as of 01:05, 16 December 2024
Line 6:		Line 6:
	Hats are items that can be equipped in the player's [[hats\|hat]] slot. These change the player sprite.		Hats are items that can be equipped in the player's [[hats\|hat]] slot. These change the player sprite.

	They have their data in <samp>Data/Hats</samp>, their in-game sprites in <samp>Characters/Farmer/hats</samp> by default, and their code in <samp>StardewValley.Objects.Hat</samp>.		They have [[Modding:Items#Item types\|item type]] <code>(H)</code> (or <code>ItemRegistry.type_hat</code> in C# code), their data in <samp>Data/Hats</samp>, their in-game sprites in <samp>Characters/Farmer/hats</samp> by default, and their code in <samp>StardewValley.Objects.Hat</samp>.

	==Data format==		==Data format==

imported>Pathoschild: adjust page post-split, add some high-level info, update outdated info

2024-12-16T00:27:09Z

adjust page post-split, add some high-level info, update outdated info

← Older revision		Revision as of 00:27, 16 December 2024
Line 1:		Line 1:
	← [[Modding:Items\|Items]]		← [[Modding:Items\|Items]]

	~~==Hats==~~		This page explains how the game stores and parses hat-type item data. For items in general, see [[Modding:Items]].
	~~Hats are~~ items ~~that can be equipped~~ in ~~the player's~~ [[~~hats\|hat~~]] ~~slot~~.

	~~They have their data in <samp>Data/~~Hats~~</samp>, their in-game sprites~~ in ~~<samp>Characters/Farmer/~~hats~~</samp>, and their code in <samp>StardewValley.Objects~~.~~Hat</samp>~~.		==Overview==
			Hats are items that can be equipped in the player's [[hats\|hat]] slot. These change the player sprite.

	~~===Data format===~~		They have their data in <samp>Data/Hats</samp>, their in-game sprites in <samp>Characters/Farmer/hats</samp> by default, and their code in <samp>StardewValley.Objects.Hat</samp>.
	~~The hat~~ data in <samp>Data/Hats</samp> ~~consists of an integer→string dictionary with entries like this:~~

	~~<syntaxhighlight lang~~=~~"json">~~		==Data format==
	~~"5": "Official Cap/Looks like it belonged to a postman or policeman. Either way, it's still very soft and smells okay./false/true"~~		The hat data in <samp>Data/Hats</samp> consists of a string → string lookup, where...
	~~</syntaxhighlight>~~		* The key is the [[Modding:Common data field types#Item ID\|unqualified item ID]].
			* The value is a slash-delimited strings with the fields listed below.
	~~Hats from the base game use the~~ hat's <samp>~~ParentSheetIndex~~</samp> ~~as its item ID~~.
	~~For each entry in the data asset, the~~ key is the ~~hat's~~ item ID~~, and the~~ value is a slash-delimited ~~string~~ with ~~these~~ fields:

	{\| class="wikitable"		{\| class="wikitable"
Line 57:		Line 54:
	\|}		\|}

	Hats have a ~~hard-coded~~ category of -95 (<samp>HatDataDefinition.~~cs::~~GetData</samp>)		Hats have a hardcoded category of -95 (see <samp>HatDataDefinition.GetData</samp> in the game code).

			==See also==
			* [[Modding:Items]] for item data in general

	[[Category:Modding]]		[[Category:Modding]]

imported>Pathoschild: unmerge from Modding:Items; attribution: Pathoschild (main author), Tlitookilakin (updated for 1.6), Esca (added 'hide' option for 'show real hair' field)

2024-12-15T17:23:29Z

unmerge from Modding:Items; attribution: Pathoschild (main author), Tlitookilakin (updated for 1.6), Esca (added 'hide' option for 'show real hair' field)

← Older revision		Revision as of 17:23, 15 December 2024
Line 1:		Line 1:
	~~#REDIRECT~~ [[Modding:Items]]		← [[Modding:Items\|Items]]

			==Hats==
			Hats are items that can be equipped in the player's [[hats\|hat]] slot.

			They have their data in <samp>Data/Hats</samp>, their in-game sprites in <samp>Characters/Farmer/hats</samp>, and their code in <samp>StardewValley.Objects.Hat</samp>.

			===Data format===
			The hat data in <samp>Data/Hats</samp> consists of an integer→string dictionary with entries like this:

			<syntaxhighlight lang="json">
			"5": "Official Cap/Looks like it belonged to a postman or policeman. Either way, it's still very soft and smells okay./false/true"
			</syntaxhighlight>

			Hats from the base game use the hat's <samp>ParentSheetIndex</samp> as its item ID.
			For each entry in the data asset, the key is the hat's item ID, and the value is a slash-delimited string with these fields:

			{\| class="wikitable"
			\|-
			! index
			! field
			! effect
			\|-
			\| 0
			\| name
			\| The internal item name.
			\|-
			\| 1
			\| description
			\| The translated item description shown in-game.
			\|-
			\| 2
			\| show real hair
			\| Whether to show the player's hairstyle as-is when the hat is worn (<samp>true</samp>), change the hairstyle to fit the hat (<samp>false</samp>), or hide their hair completely (<samp>hide</samp>).
			\|-
			\| 3
			\| skip hairstyle offset
			\| Whether to ignore the current style when positioning the hat (one of <samp>true</samp> or <samp>false</samp>). For example, the [[Eye Patch\|eye patch]] sets <samp>true</samp> since its position isn't affected by the hair, but the [[Butterfly Bow\|butterfly bow]] sets <samp>false</samp> to adjust its position on top of your hair.
			\|-
			\| 4
			\| tags
			\| A space-separated list of "tags". These are separate from context tags, and used to contain miscellaneous information. Currently, the only tag used by the game is <samp>Prismatic</samp>, which marks a hat as prismatic and causes it to cycle through colors.
			\|-
			\| 5
			\| display name
			\| The translated item name shown in-game.
			\|-
			\| 6
			\| sprite index
			\| The index in the hat spritesheet used to display this hat (see field 7 for the texture layout).
			\|-
			\| 7
			\| texture name
			\| The name of the game texture to use for the hat. If empty, the game will use the default hat sheet <samp>Characters/Farmer/hats</samp>.

			Each hat in the texture should have a 20x80 pixel area, consisting of four 20x20 hat sprites from top to bottom: facing down, right, left, and up. The texture can have any width and height that's evenly divisible by 20 and 80 respectively.
			\|}

			Hats have a hard-coded category of -95 (<samp>HatDataDefinition.cs::GetData</samp>)

			[[Category:Modding]]

imported>Pathoschild: Pathoschild moved page Modding:Hat data to Modding:Hats: update for newer naming convention & prepare to unsplit page

2024-12-15T17:21:42Z

Pathoschild moved page Modding:Hat data to Modding:Hats: update for newer naming convention & prepare to unsplit page

← Older revision		Revision as of 17:21, 15 December 2024
(No difference)

imported>Pathoschild: merge into Modding:Items

2022-01-28T03:03:30Z

merge into Modding:Items

Show changes

imported>Margotbean: Text replacement - "tt>" to "samp>"

2021-11-04T18:48:06Z

Text replacement - "tt>" to "samp>"

← Older revision		Revision as of 18:48, 4 November 2021
Line 4:		Line 4:

	==Raw data==		==Raw data==
	Hat data is stored in <tt>Content\Data\hats.xnb</tt>, which can be [[Modding:Editing XNB files#unpacking\|unpacked for editing]]. Here's the raw data as of {{version\|1.5.1}} for reference:		Hat data is stored in <samp>Content\Data\hats.xnb</samp>, which can be [[Modding:Editing XNB files#unpacking\|unpacked for editing]]. Here's the raw data as of {{version\|1.5.1}} for reference:

	{{collapse\|Data\|content=<syntaxhighlight lang="json">		{{collapse\|Data\|content=<syntaxhighlight lang="json">
Line 107:		Line 107:
	==Format==		==Format==

	Hats have a hard-coded category of -95 (<tt>Hats.cs::Load</tt>)		Hats have a hard-coded category of -95 (<samp>Hats.cs::Load</samp>)
	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-

imported>Margotbean: +RU link

2021-08-17T17:01:47Z

+RU link

← Older revision		Revision as of 17:01, 17 August 2021
Line 140:		Line 140:

	[[Category:Modding]]		[[Category:Modding]]

			[[ru:Модификации:Головные уборы]]

imported>RetroEdit: Replace deprecated tags with tags

2021-02-19T17:09:51Z

Replace deprecated <source> tags with <syntaxhighlight> tags

← Older revision		Revision as of 17:09, 19 February 2021
Line 6:		Line 6:
	Hat data is stored in <tt>Content\Data\hats.xnb</tt>, which can be [[Modding:Editing XNB files#unpacking\|unpacked for editing]]. Here's the raw data as of {{version\|1.5.1}} for reference:		Hat data is stored in <tt>Content\Data\hats.xnb</tt>, which can be [[Modding:Editing XNB files#unpacking\|unpacked for editing]]. Here's the raw data as of {{version\|1.5.1}} for reference:

	{{collapse\|Data\|content=<~~source~~ lang="json">		{{collapse\|Data\|content=<syntaxhighlight lang="json">
	{		{
	"0": "Cowboy Hat/The leather is old and cracked, but surprisingly supple. It smells musty./false/true",		"0": "Cowboy Hat/The leather is old and cracked, but surprisingly supple. It smells musty./false/true",
Line 103:		Line 103:
	"93": "Warrior Helmet/An Ostrich eggshell repurposed into a helmet./false/true"		"93": "Warrior Helmet/An Ostrich eggshell repurposed into a helmet./false/true"
	}		}
	</~~source~~>}}		</syntaxhighlight>}}

	==Format==		==Format==

imported>Pathoschild: /* Raw data */ update for 1.5.1 (no content changes)

2020-12-29T17:49:10Z

Raw data: update for 1.5.1 (no content changes)

← Older revision		Revision as of 17:49, 29 December 2020
Line 4:		Line 4:

	==Raw data==		==Raw data==
	Hat data is stored in <tt>Content\Data\hats.xnb</tt>, which can be [[Modding:Editing XNB files#unpacking\|unpacked for editing]]. Here's the raw data as of {{version\|1.5}} for reference:		Hat data is stored in <tt>Content\Data\hats.xnb</tt>, which can be [[Modding:Editing XNB files#unpacking\|unpacked for editing]]. Here's the raw data as of {{version\|1.5.1}} for reference:

	{{collapse\|Data\|content=<source lang="json">		{{collapse\|Data\|content=<source lang="json">
Line 102:		Line 102:
	"92": "???/???/hide/true",		"92": "???/???/hide/true",
	"93": "Warrior Helmet/An Ostrich eggshell repurposed into a helmet./false/true"		"93": "Warrior Helmet/An Ostrich eggshell repurposed into a helmet./false/true"
	}</source>}}		}
			</source>}}

	==Format==		==Format==