Modding:NPC data - Revision history

imported>Margotbean: RU link

2026-05-17T19:20:13Z

RU link

← Older revision		Revision as of 19:20, 17 May 2026
Line 767:		Line 767:
	[[es:Modding:Datos de NPC]]		[[es:Modding:Datos de NPC]]
	[[pt:Modificações:Dados do NPC]]		[[pt:Modificações:Dados do NPC]]
	[[ru:Модификации:О NPC]]		[[ru:Модификации:Данные NPC]]
	[[zh:模组:NPC数据]]		[[zh:模组:NPC数据]]

imported>SwagChild: /* Festivals */ Added an example for how WinterStarGifts works.

2025-11-22T18:10:40Z

Festivals: Added an example for how WinterStarGifts works.

← Older revision		Revision as of 18:10, 22 November 2025
Line 279:		Line 279:
	If set to an [[Modding:Item queries\|item query]] which returns multiple items, one of them will be selected at random.		If set to an [[Modding:Item queries\|item query]] which returns multiple items, one of them will be selected at random.
	\|}		\|}
			For example, an NPC gifting you a [[Tea Set]] would look like this:
			<syntaxhighlight lang="json">
			"WinterStarGifts": [
			{
			"Id": "Tea Set",
			"ItemId": "(O)341",
			}
			]
			</syntaxhighlight>
	\|}		\|}

imported>SwagChild: /* Gift tastes */ Removed example of multiline readability from this section (added to Modding:Gift taste data instead, where it makes more sense)

2025-11-22T17:01:25Z

Gift tastes: Removed example of multiline readability from this section (added to Modding:Gift taste data instead, where it makes more sense)

← Older revision		Revision as of 17:01, 22 November 2025
Line 487:		Line 487:
	: <syntaxhighlight lang="yaml">Abigail: "I seriously love this! You're the best, @!/66 128 220 226 276 611/Hey, how'd you know I was hungry? This looks delicious!//What am I supposed to do with this?/-5 -75 -79 16 245 246/What were you thinking? This is awful!/330/You brought me a present? Thanks.//" </syntaxhighlight>		: <syntaxhighlight lang="yaml">Abigail: "I seriously love this! You're the best, @!/66 128 220 226 276 611/Hey, how'd you know I was hungry? This looks delicious!//What am I supposed to do with this?/-5 -75 -79 16 245 246/What were you thinking? This is awful!/330/You brought me a present? Thanks.//" </syntaxhighlight>

	: The line can be broken down into 5 pairs of dialogue + item IDs in this order: Love, Like, Dislike, Hate, Neutral. If a dialogue field is empty, the game will use a generic dialogue text. See [[Modding:Objects]] for the object IDs.		: The line can be broken down into 5 pairs of dialogue + item IDs in this order: Love, Like, Dislike, Hate, Neutral. These dialogue pairs can be multilined after the / delimiter for readability. If a dialogue field is empty, the game will use a generic dialogue text. See [[Modding:Objects]] for the object IDs.

	~~: Gift dialogue can also be multilined after the / delimiter for readability, like this:~~
	~~: <syntaxhighlight lang="yaml">Abigail: "~~
	~~I seriously love this! You're the best, @!/66 128 220 226 276 611/~~
	~~Hey, how'd you know I was hungry? This looks delicious!//~~
	~~What am I supposed to do with this?/-5 -75 -79 16 245 246/~~
	~~What were you thinking? This is awful!/330/~~
	~~You brought me a present? Thanks.//~~
	~~" </syntaxhighlight>~~



	; gift dialogue		; gift dialogue

imported>SwagChild: /* Gift tastes */ Added multilining for readablity as a feature to gift dialogue, with an example of how this is done.

2025-11-22T16:48:56Z

Gift tastes: Added multilining for readablity as a feature to gift dialogue, with an example of how this is done.

← Older revision		Revision as of 16:48, 22 November 2025
Line 488:		Line 488:

	: The line can be broken down into 5 pairs of dialogue + item IDs in this order: Love, Like, Dislike, Hate, Neutral. If a dialogue field is empty, the game will use a generic dialogue text. See [[Modding:Objects]] for the object IDs.		: The line can be broken down into 5 pairs of dialogue + item IDs in this order: Love, Like, Dislike, Hate, Neutral. If a dialogue field is empty, the game will use a generic dialogue text. See [[Modding:Objects]] for the object IDs.

			: Gift dialogue can also be multilined after the / delimiter for readability, like this:
			: <syntaxhighlight lang="yaml">Abigail: "
			I seriously love this! You're the best, @!/66 128 220 226 276 611/
			Hey, how'd you know I was hungry? This looks delicious!//
			What am I supposed to do with this?/-5 -75 -79 16 245 246/
			What were you thinking? This is awful!/330/
			You brought me a present? Thanks.//
			" </syntaxhighlight>



	; gift dialogue		; gift dialogue

imported>SwagChild: /* Hidden gift log emote */ cue ID now properly links to Modding:Audio#Sound

2025-11-22T14:23:54Z

Hidden gift log emote: cue ID now properly links to Modding:Audio#Sound

← Older revision		Revision as of 14:23, 22 November 2025
Line 433:		Line 433:
	\|-		\|-
	\| <samp>HiddenProfileEmoteSound</samp>		\| <samp>HiddenProfileEmoteSound</samp>
	\| ''(Optional)'' For the [[Secrets#Gift Log\|hidden gift log emote]], the [[#~~Custom audio~~\|cue ID]] for the sound played when clicking the sprite. Defaults to <samp>drumkit6</samp>.		\| ''(Optional)'' For the [[Secrets#Gift Log\|hidden gift log emote]], the [[Modding:Audio#Sound\|cue ID]] for the sound played when clicking the sprite. Defaults to <samp>drumkit6</samp>.
	\|-		\|-
	\| <samp>HiddenProfileEmoteDuration</samp>		\| <samp>HiddenProfileEmoteDuration</samp>

imported>SwagChild: /* Overworld sprites */ Added "first frame counts as frame 0" for clarity.

2025-11-07T21:34:54Z

Overworld sprites: Added "first frame counts as frame 0" for clarity.

← Older revision		Revision as of 21:34, 7 November 2025
Line 498:		Line 498:
	[[File:Abigail-sprite-sheet.png\|thumb\|The sprite sheet for Abigail.]]		[[File:Abigail-sprite-sheet.png\|thumb\|The sprite sheet for Abigail.]]

	The overworld sprites are stored in <samp>Characters/NpcName</samp>, including movement and animation frames. Each frame is exactly 16x32 pixels.		The overworld sprites are stored in <samp>Characters/NpcName</samp>, including movement and animation frames. Each frame is exactly 16x32 pixels. Note that the first frame counts as frame 0.
	<ul>		<ul>
	<li>the first sixteen frames are generic movement (four frames per direction);</li>		<li>the first sixteen frames are generic movement (four frames per direction);</li>

imported>SwagChild: /* Gift tastes */ removed a duplicated word.

2025-11-06T15:06:07Z

Gift tastes: removed a duplicated word.

← Older revision		Revision as of 15:06, 6 November 2025
Line 490:		Line 490:

	; gift dialogue		; gift dialogue
	: When you gift an NPC, they'll show a ~~dialogue~~ [[Modding:Dialogue\|dialogue]] in this order:		: When you gift an NPC, they'll show a [[Modding:Dialogue\|dialogue]] in this order:
	:# on their birthday, an <samp>AcceptBirthdayGift</samp> dialogue key, else a default dialogue like <samp>NPC.cs.4274</samp> ("''You remembered my birthday? I'm impressed. Thanks.$h''");		:# on their birthday, an <samp>AcceptBirthdayGift</samp> dialogue key, else a default dialogue like <samp>NPC.cs.4274</samp> ("''You remembered my birthday? I'm impressed. Thanks.$h''");
	:# an <samp>AcceptGift_*</samp> dialogue;		:# an <samp>AcceptGift_*</samp> dialogue;

imported>Pathoschild: + common limitation: NPCs added to existing save may not follow schedule on first day

2025-07-17T14:32:15Z

+ common limitation: NPCs added to existing save may not follow schedule on first day

← Older revision		Revision as of 14:32, 17 July 2025
Line 747:		Line 747:
	}		}
	</syntaxhighlight>		</syntaxhighlight>

			==Limitations==
			* When an NPC is added to an existing save, they generally don't follow their schedule correctly until you've slept once in-game (which triggers their first day update).<!-- This is duplicated on [[Modding:Schedule data]], update both places if needed. -->

	==See also==		==See also==

imported>BarleyZP: Small note that vanilla NPCs have their names in Strings/NPCNames

2025-05-14T17:57:51Z

Small note that *vanilla* NPCs have their names in Strings/NPCNames

← Older revision		Revision as of 17:57, 14 May 2025
Line 7:		Line 7:

	===Main data===		===Main data===
	The <samp>Data/Characters</samp> asset contains most of the data about an NPC. That includes their name, social info (e.g. personality, birthday, and romance), appearance, spouse room & patio, festival participation, etc. (Note that all translated NPC names are in <samp>Strings/NPCNames</samp>).		The <samp>Data/Characters</samp> asset contains most of the data about an NPC. That includes their name, social info (e.g. personality, birthday, and romance), appearance, spouse room & patio, festival participation, etc. (Note that all translated vanilla NPC names are in <samp>Strings/NPCNames</samp>).

	This consists of a string → model lookup, where...		This consists of a string → model lookup, where...

imported>BarleyZP: /* Main data */ add info about Strings/NPCNames from Modding:Migrate to Stardew Valley 1.6 (main author Pathoschild)

2025-05-14T17:56:02Z

Main data: add info about Strings/NPCNames from Modding:Migrate to Stardew Valley 1.6 (main author Pathoschild)

← Older revision		Revision as of 17:56, 14 May 2025
Line 7:		Line 7:

	===Main data===		===Main data===
	The <samp>Data/Characters</samp> asset contains most of the data about an NPC. That includes their name, social info (e.g. personality, birthday, and romance), appearance, spouse room & patio, festival participation, etc.		The <samp>Data/Characters</samp> asset contains most of the data about an NPC. That includes their name, social info (e.g. personality, birthday, and romance), appearance, spouse room & patio, festival participation, etc. (Note that all translated NPC names are in <samp>Strings/NPCNames</samp>).

	This consists of a string → model lookup, where...		This consists of a string → model lookup, where...