Modding:Stats - Revision history

imported>Pathoschild: /* Items collected */ CaveCarrotsFound broken, removed in 1.6.16

2026-02-16T00:31:25Z

Items collected: CaveCarrotsFound broken, removed in 1.6.16

← Older revision		Revision as of 00:31, 16 February 2026
Line 214:		Line 214:
	\| <samp>CaveCarrotsFound</samp>		\| <samp>CaveCarrotsFound</samp>
	\| The number of [[Cave Carrot\|cave carrots]] found by the player by digging them up. (Cave carrots found any other way aren't counted.)		\| The number of [[Cave Carrot\|cave carrots]] found by the player by digging them up. (Cave carrots found any other way aren't counted.)

			<p>'''Bug:''' this stat isn't actually tracked correctly, and will always be zero. {{upcoming\|1.6.16\|This stat is removed in 1.6.16.\|inline=1}}</p>
	\|-		\|-
	\| <samp>CheeseMade</samp><br /><samp>GoatCheeseMade</samp>		\| <samp>CheeseMade</samp><br /><samp>GoatCheeseMade</samp>

imported>Pathoschild: /* Player activity */ note AverageBedtime + WeedsEliminated bugs

2026-02-15T23:33:47Z

Player activity: note AverageBedtime + WeedsEliminated bugs

← Older revision		Revision as of 23:33, 15 February 2026
Line 54:		Line 54:
	\| <samp>AverageBedTime</samp>		\| <samp>AverageBedTime</samp>
	\| The average in-game time when the player went to sleep each day since the save started.		\| The average in-game time when the player went to sleep each day since the save started.

			'''Bug:''' this stat tracks the average ''display time'', not the actual time. For example, the average of 6am (0600) + 7am (0700) is incorrectly calculated as 0650 instead of 0630. {{upcoming\|1.6.16\|This is fixed in 1.6.16.\|inline=1}}
	\|-		\|-
	\| <samp>BillboardQuestsDone</samp>		\| <samp>BillboardQuestsDone</samp>
Line 192:		Line 194:
	\| <samp>WeedsEliminated</samp>		\| <samp>WeedsEliminated</samp>
	\| The number of [[weeds]] destroyed by the player (including with bombs or scythes).		\| The number of [[weeds]] destroyed by the player (including with bombs or scythes).

			'''Bug:''' this stat only tracks weeds destroyed indirectly (e.g. using a [[bomb]]), not those cut directly using a tool. {{upcoming\|1.6.16\|This is fixed in 1.6.16.\|inline=1}}
	\|-		\|-
	\| <samp>WildTreesPlanted</samp>		\| <samp>WildTreesPlanted</samp>

imported>Pathoschild: /* Player activity */ note bug: OtherPreciousGemsFound not tracked correctly in newer versions of the game

2026-02-15T22:44:44Z

Player activity: note bug: OtherPreciousGemsFound not tracked correctly in newer versions of the game

← Older revision		Revision as of 22:44, 15 February 2026
Line 134:		Line 134:
	\| <samp>OtherPreciousGemsFound</samp>		\| <samp>OtherPreciousGemsFound</samp>
	\| The number of [[Mining#Gem Node\|gem mine nodes]] broken by the player.		\| The number of [[Mining#Gem Node\|gem mine nodes]] broken by the player.

			'''Bug:''' this stat isn't tracked correctly in later versions of the game. {{upcoming\|1.6.16\|This is fixed in 1.6.16.\|inline=1}}
	\|-		\|-
	\| <samp>PiecesOfTrashRecycled</samp>		\| <samp>PiecesOfTrashRecycled</samp>

imported>Pathoschild: /* Player activity */ correct description for IndividualMoneyEarned

2026-02-15T22:08:18Z

Player activity: correct description for IndividualMoneyEarned

← Older revision		Revision as of 22:08, 15 February 2026
Line 109:		Line 109:
	\|-		\|-
	\| <samp>IndividualMoneyEarned</samp>		\| <samp>IndividualMoneyEarned</samp>
	\| The total gold earned by the player~~. In~~ multiplayer~~, this excludes gold earned when the~~ [[Multiplayer#Money\|~~shared money~~ option]] is enabled.		\| The total gold earned by the player while the multiplayer [[Multiplayer#Money\|separate wallets option]] is enabled.
	\|-		\|-
	\| <samp>ItemsCooked</samp>		\| <samp>ItemsCooked</samp>

imported>Sunbeam135: /* World activity */

2026-01-03T11:50:15Z

World activity

← Older revision		Revision as of 11:50, 3 January 2026
Line 343:		Line 343:
	[[Category:Modding]]		[[Category:Modding]]

			[[ru:Модификации:Статистика]]
	[[zh:模组:统计数据]]		[[zh:模组:统计数据]]

imported>Pathoschild: /* Format */ fix typo

2025-10-09T23:39:21Z

Format: fix typo

← Older revision		Revision as of 23:39, 9 October 2025
Line 7:		Line 7:
	Each stat is identified by a [[Modding:Common data field types#Unique string ID\|unique string ID]] (i.e. the ''stat key''). Stat keys are case-insensitive, so <samp>stepsTaken</samp> and <samp>STEPSTAKEN</samp> are equivalent.		Each stat is identified by a [[Modding:Common data field types#Unique string ID\|unique string ID]] (i.e. the ''stat key''). Stat keys are case-insensitive, so <samp>stepsTaken</samp> and <samp>STEPSTAKEN</samp> are equivalent.

	Stat values are positive ~~integer~~ from 0 to [https://learn.microsoft.com/en-us/dotnet/api/system.uint32.maxvalue 4.2 billion] (default 0).		Stat values are positive integers from 0 to [https://learn.microsoft.com/en-us/dotnet/api/system.uint32.maxvalue 4.2 billion] (default 0).

	===Reference stats in mod code===		===Reference stats in mod code===

imported>VulpesLucida: +zh link

2025-09-28T10:29:53Z

+zh link

← Older revision		Revision as of 10:29, 28 September 2025
Line 342:		Line 342:

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

			[[zh:模组:统计数据]]

imported>Pathoschild: /* Reference stats in mod code */ + IncrementStat trigger action, expand info about custom keys

2025-09-20T21:57:00Z

Reference stats in mod code: + IncrementStat trigger action, expand info about custom keys

← Older revision		Revision as of 21:57, 20 September 2025
Line 15:		Line 15:
	* or in C# like <code>uint stepsTaken = Game1.player.stats.Get(StatKeys.StepsTaken)</code> (where <samp>StatKeys</samp> has constants for all of the base game's stats).		* or in C# like <code>uint stepsTaken = Game1.player.stats.Get(StatKeys.StepsTaken)</code> (where <samp>StatKeys</samp> has constants for all of the base game's stats).

	Mods can ~~add custom~~ stats...		Mods can set stats...
	* in [[Modding:Content Patcher\|Content Patcher packs]] via ~~data fields like~~ [[Modding:~~Machines~~\|<samp>StatsToIncrementWhenLoaded</samp> in <samp>Data/Machines</samp>]];		* in [[Modding:Content Patcher\|Content Patcher packs]] via the <samp>IncrementStat</samp> [[Modding:Trigger actions\|trigger action]] or data fields like <samp>StatsToIncrementWhenLoaded</samp> in [[Modding:Machines\|<samp>Data/Machines</samp>]];
	* or in C# code via the <samp>Game1.player.stats</samp> API (like <code>Game1.player.stats.Increment($"{this.ModManifest.UniqueID}_ExampleStat")</code>).		* or in C# code via the <samp>Game1.player.stats</samp> API (like <code>Game1.player.stats.Increment($"{this.ModManifest.UniqueID}_ExampleStat")</code>).

			Stats can have arbitrary keys and are managed automatically by the game. For example:
			* getting a stat which doesn't exist will just return zero;
			* setting a stat which doesn't exist like <code><nowiki>IncrementStat {{ModId}}_CustomStat</nowiki></code> will just add it with the new value;
			* and reducing a stat to zero will remove the stat (since a stat which doesn't exist has a zero value).

	===Caveats===		===Caveats===

imported>Pathoschild: document stats

2025-09-20T21:44:40Z

document stats

New page

← [[Modding:Index|Index]]

This page documents '''stats''', which track simple numeric values in the game state. Stats are tracked separately for each player, though some stats represent global values.

==Overview==
===Format===
Each stat is identified by a [[Modding:Common data field types#Unique string ID|unique string ID]] (i.e. the ''stat key''). Stat keys are case-insensitive, so <samp>stepsTaken</samp> and <samp>STEPSTAKEN</samp> are equivalent.

Stat values are positive integer from 0 to [https://learn.microsoft.com/en-us/dotnet/api/system.uint32.maxvalue 4.2 billion] (default 0).

===Reference stats in mod code===
You can check stats...
* using a [[Modding:Game state queries|game state query]] like <code>PLAYER_STAT Current stepsTaken 500</code> (i.e. current player has taken 500+ steps);
* using a [[Modding:Console commands|debug command]] like <code>debug getStat stepsTaken</code>;
* or in C# like <code>uint stepsTaken = Game1.player.stats.Get(StatKeys.StepsTaken)</code> (where <samp>StatKeys</samp> has constants for all of the base game's stats).

Mods can add custom stats...
* in [[Modding:Content Patcher|Content Patcher packs]] via data fields like [[Modding:Machines|<samp>StatsToIncrementWhenLoaded</samp> in <samp>Data/Machines</samp>]];
* or in C# code via the <samp>Game1.player.stats</samp> API (like <code>Game1.player.stats.Increment($"{this.ModManifest.UniqueID}_ExampleStat")</code>).

===Caveats===
Stats are ''not'' synced in [[multiplayer]], so farmhands can only access their own stats (not stats on the host or other farmhands).

==Built-in stats==
This section lists the stats tracked by the base game.

===Currency & scores===
{| class="wikitable"
|-
! stat key
! tracks
|-
| <samp>SpecialOrderPrizeTickets</samp>
| The player's current number of [[Prize Ticket|prize tickets]].
|-
| <samp>SquidFestScore_{{t|day}}_{{t|year}}</samp>
| The player's [[SquidFest]] score for a specific date.
|}

===Player activity===
{| class="wikitable"
|-
! stat key
! tracks
|-
| <samp>ArtifactSpotsDug</samp>
| The number of [[Artifact Spot|artifact spots]] dug up by this player using a [[hoe]].
|-
| <samp>AverageBedTime</samp>
| The average in-game time when the player went to sleep each day since the save started.
|-
| <samp>BillboardQuestsDone</samp>
| The number of [[Quests|'help wanted' billboard quests]] completed by the player.
|-
| <samp>BoatRidesToIsland</samp>
| The number of times the player took [[Fish Shop#Willy's Boat|Willy's boat]] to [[Ginger Island]].
|-
| <samp>ChildrenTurnedToDoves</samp>
| The number of children which the player sacrificed to the [[Dark Shrine of Selfishness]].
|-
| <samp>CompletedJunimoKart</samp>
| The number of times the player completed [[Junimo Kart]].

⚠ This was added in {{version|1.6.9|Stardew Valley 1.6.9}}, so multiple completions in previous versions count as 1.
|-
| <samp>CompletedPrairieKing</samp>
| The number of times the player completed [[Journey of the Prairie King]].

⚠ This was added in {{version|1.6.9|Stardew Valley 1.6.9}}, so multiple completions in previous versions count as 1.
|-
| <samp>CompletedPrairieKingWithoutDying</samp>
| The number of times the player completed [[Journey of the Prairie King]] without dying.

⚠ This was added in {{version|1.6.9|Stardew Valley 1.6.9}}, so completions in previous versions aren't counted.
|-
| <samp>DirtHoed</samp>
| The number of times the player tiled dirt using a [[hoe]].
|-
| <samp>ExMemoriesWiped</samp>
| The number of times the player sacrificed their ex-spouse's memories at the [[Dark Shrine of Memory]].
|-
| <samp>FishCaught</samp> <samp>PreciseFishCaught</samp>
| The number of fish caught by the player while fishing.

<samp>PreciseFishCaught</samp> is a subset of <samp>FishCaught</samp> which ignores some catches which don't strictly count as 'fish' (i.e. items which don't have the ''Fish'' [[Modding:Items#Categories|category]] or <samp>counts_as_fish_catch</samp> [[Modding:Context tags|context tag]]). For example, [[seaweed]] counts for <samp>FishCaught</samp> but not for <samp>PreciseFishCaught</samp>.
|-
| <samp>FishingTreasures</samp>
| The number of treasure boxes opened while catching a fish.
|-
| <samp>GeodesCracked</samp>
| The number of [[geode]]s '''and''' [[Mystery Box|mystery boxes]] broken open by the player at Clint's shop or by placing them in a [[Geode Crusher|geode crusher]]. See also <samp>MysteryBoxesOpened</samp>.
|-
| <samp>GiftsGiven</samp>
| The number of items which the player gave to NPCs as gifts. (This doesn't count items given to NPCs for other purposes like events or quests.)
|-
| <samp>GoldenTagsTurnedIn</samp>
| The number of [[Golden Tag|golden tags]] redeemed by the player at the [[Trout Derby]].
|-
| <samp>GoodFriends</samp>
| The number of NPCs with which the player has 8+ hearts of [[friendship]].
|-
| <samp>hardModeMonstersKilled</samp>
| The number of [[The Mines#Shrine of Challenge|'dangerous']] monsters killed by the player.
|-
| <samp>IndividualMoneyEarned</samp>
| The total gold earned by the player. In multiplayer, this excludes gold earned when the [[Multiplayer#Money|shared money option]] is enabled.
|-
| <samp>ItemsCooked</samp>
| The number of items created from [[cooking]] recipes by the player.
|-
| <samp>ItemsCrafted</samp>
| The number of items created from [[crafting]] recipes by the player.
|-
| <samp>ItemsForaged</samp>
| The number of [[forage]] items harvested by the player (including forage crops).
|-
| <samp>MonstersKilled</samp>
| The number of monsters killed by the player.
|-
| <samp>MossHarvested</samp>
| The number of times moss was harvested from trees by the player.
|-
| <samp>MysteryBoxesOpened</samp>
| The number of mystery boxes opened by the player at Clint's shop or by placing them in a geode crusher. See also <samp>GeodesCracked</samp>.
|-
| <samp>MysticStonesCrushed</samp>
| The number of [[Mining#Mystic Stone|mystic mine nodes]] broken by the player.
|-
| <samp>OtherPreciousGemsFound</samp>
| The number of [[Mining#Gem Node|gem mine nodes]] broken by the player.
|-
| <samp>PiecesOfTrashRecycled</samp>
| The number of items placed in [[Recycling Machine|recycling machines]] by the player.
|-
| <samp>PreservesMade</samp>
| The number of items collected from [[Preserves Jar|preserves jars]] by the player.
|-
| <samp>QuestsCompleted</samp>
| The number of [[quests]] and [[Special Orders|special orders]] completed by the player.

For farmhands, a special order is counted if they're online when it's completed.
|-
| <samp>RocksCrushed</samp>
| The number of times the player broke a rock using a [[pickaxe]].
|-
| <samp>SeedsSown</samp>
| The number of [[crops|crop]] seeds planted by the player (including seeds planted in [[Garden Pot|garden pots]] or in dirt).
|-
| <samp>SlimesKilled</samp>
| The number of slimes killed by the player. This includes [[slimes|slime monsters]], [[Slimes#Big Slimes|big slime monsters]], and slimes bred by the player (e.g. in a [[Slime Hutch|slime hutch]]).
|-
| <samp>StepsTaken</samp>
| The total number of steps taken by the player.
|-
| <samp>StumpsChopped</samp>
| The number of [[Large Stump|large stumps]] and [[Large Log|hollow logs]] broken by the player.
|-
| <samp>TicketPrizesClaimed</samp>
| The number of times the player redeemed a [[Prize Ticket|prize ticket]].
|-
| <samp>TimesEnchanted</samp>
| The number of times the player enchanted a tool or weapon at the [[forge]].
|-
| <samp>TimesFished</samp>
| The number of times the player cast the fishing rod into water (regardless of whether they caught anything).
|-
| <samp>TimesPanned</samp>
| The number of times the player found items while [[pan]]ning.
|-
| <samp>TimesTossedBaby</samp>
| The number of times the player tossed a baby in the air.
|-
| <samp>TimesUnconscious</samp>
| The number of times the player was knocked out due to their health reaching zero.
|-
| <samp>TotalMoneyGifted</samp>
| The total gold which this player sent to other players through the [[Mayor's Manor#Multiplayer Funds|town ledger]].
|-
| <samp>TrashCansChecked</samp>
| The number of times the player rummaged through a [[Garbage Can|trash can]].
|-
| <samp>TreesChopped</samp>
| The number of [[Trees|wild trees]] chopped down by the player.
|-
| <samp>WeedsEliminated</samp>
| The number of [[weeds]] destroyed by the player (including with bombs or scythes).
|-
| <samp>WildTreesPlanted</samp>
| The number of [[Trees|wild tree]] seeds planted by the player.
|}

===Items collected===
These track the number of individual items collected by players. Some stats under [[#Player activity|''player activity'']] track how many times the player performed a related action (e.g. <samp>ItemsForaged</samp> counts the number of times they harvested forage crops).

{| class="wikitable"
|-
! stat key
! tracks
|-
| <samp>BeveragesMade</samp>
| The number of items collected from [[keg]]s by the player.
|-
| <samp>CaveCarrotsFound</samp>
| The number of [[Cave Carrot|cave carrots]] found by the player by digging them up. (Cave carrots found any other way aren't counted.)
|-
| <samp>CheeseMade</samp> <samp>GoatCheeseMade</samp>
| The number of items collected from [[Cheese Press|cheese presses]] by the player. [[Goat Cheese|Goat cheese]] increments <samp>GoatCheeseMade</samp> (not <samp>CheeseMade</samp>); any other item increments <samp>CheeseMade</samp>.
|-
| <samp>CopperFound</samp> <samp>DiamondsFound</samp> <samp>GoldFound</samp> <samp>IridiumFound</samp> <samp>IronFound</samp> <samp>NotesFound</samp></samp> <samp>PrismaticShardsFound</samp> <samp>StoneGathered</samp>
| The number of each item received by the player which was never previously in a player inventory.

For example: copper ore collected after breaking a mine rock counts, but dropping the copper ore and picking it back up would not, nor would receiving copper ore from another player.

The matching items are:
* [[Copper Ore|copper ore]]: <samp>CopperFound</samp>;
* [[Diamond|diamonds]]: <samp>DiamondsFound</samp>;
* [[Gold Ore|gold ore]]: <samp>GoldFound</samp>;
* [[Iridium Ore|iridium ore]]: <samp>IridiumFound</samp>;
* [[Iron Ore|iron ore]]: <samp>IronFound</samp>;
* [[Lost Books|lost books]]: <samp>NotesFound</samp> (not to be confused with [[Secret Notes|secret notes]]);
* [[Prismatic Shard|prismatic shards]]: <samp>PrismaticShardsFound</samp>;
* [[stone]]: <samp>StoneGathered</samp>.
|}

===Buffs & skills===
{| class="wikitable"
|-
! stat key
! tracks
|-
| <samp>BlessingOfWaters</samp>
| The current [[Statue Of Blessings|Blessings of Waters]] count. This starts at 3 when the blessing is granted, and decrements by one for each fish caught.
|-
| <samp>Book_{{t|book ID}}</samp>
| Whether the player has read a [[Books|power or skill book]], where <samp>0</samp> is false and <samp>1</samp> (or higher values) means true. The {{t|book ID}} is the [[Modding:Common data field types#Item ID|unqualified item ID]] for the book [[Modding:Objects|object]].

The matching books are:
* [[Animal Catalogue]]: <samp>Book_AnimalCatalogue</samp>;
* [[Book of Mysteries]]: <samp>Book_Mystery</samp>;
* [[Dwarvish Safety Manual]]: <samp>Book_Bombs</samp>.
* [[Friendship 101]]: <samp>Book_Friendship</samp>;
* [[Horse: The Book]]: <samp>Book_Horse</samp>;
* [[Jack Be Nimble, Jack Be Thick]]: <samp>Book_Defense</samp>;
* [[Jewels Of The Sea]]: <samp>Book_Roe</samp>;
* [[Mapping Cave Systems]]: <samp>Book_Marlon</samp>;
* [[Monster Compendium]]: <samp>Book_Void</samp>;
* [[Ol' Slitherlegs]]: <samp>Book_Grass</samp>;
* [[Price Catalogue]]: <samp>Book_PriceCatalogue</samp>;
* [[Queen Of Sauce Cookbook]]: <samp>Book_QueenOfSauce</samp>;
* [[Raccoon Journal]]: <samp>Book_WildSeeds</samp>;
* [[The Alleyway Buffet]]: <samp>Book_Trash</samp>;
* [[The Art O' Crabbing]]: <samp>Book_Crabbing</samp>;
* [[The Diamond Hunter]]: <samp>Book_Diamonds</samp>;
* [[Treasure Appraisal Guide]]: <samp>Book_Artifact</samp>;
* [[Way Of The Wind pt. 1]]: <samp>Book_Speed</samp>;
* [[Way Of The Wind pt. 2]]: <samp>Book_Speed2</samp>;
* [[Woody's Secret]]: <samp>Book_Woodcutting</samp>.
|-
| <samp>MasteryExp</samp>
| The total [[Mastery Cave|mastery]] experience points earned by the player.
|-
| <samp>MasteryLevelsSpent</samp>
| The number of [[Mastery Cave|mastery]] levels claimed by the player.
|-
| <samp>Mastery_{{t|skill ID}}</samp>
| Whether the player has unlocked a [[Mastery Cave|mastery level]] for a [[Skills|skill]]. The {{t|skill ID}} is one of <samp>0</samp> (farming), <samp>1</samp> (fishing), <samp>2</samp> (foraging), <samp>3</samp> (mining), or <samp>4</samp> (combat).
|-
| <samp>TrinketSlots</samp>
| The number of trinket slots unlocked by the player.

This should be 0 or 1; any number beyond that is equivalent to 1.
|}

===World activity===
'''⚠ In [[multiplayer]], these are primarily tracked for the main player. Make sure to read the full description before using them with a farmhand.'''

{| class="wikitable"
|-
! stat key
! tracks
|-
| <samp>BeachFarmSpawns</samp>
| The total number of beach forage which spawned on the [[Farm Maps|beach farm]].

⚠ For farmhands in multiplayer, the value is always zero.
|-
| <samp>ChickenEggsLayed</samp>
| The number of eggs produced by [[chicken]]s.

⚠ For farmhands in multiplayer, the value is always zero.
|-
| <samp>CowMilkProduced</samp>
| The number of milk items produced by [[cow]]s.

⚠ For farmhands in multiplayer, the value is always zero.
|-
| <samp>CropsShipped</samp>
| The number of items with the ''Fruit'' or ''Vegetable'' [[Modding:Items#Categories|category]] shipped by any players. See also <samp>ItemsShipped</samp>.

⚠ For farmhands in multiplayer, this is the number shipped while they were online to see the end-of-day shipping screen.
|-
| <samp>DuckEggsLayed</samp>
| The number of eggs produced by [[duck]]s.

⚠ For farmhands in multiplayer, the value is always zero.
|-
| <samp>DaysPlayed</samp>
| The number of days completed (i.e. times slept) by the player, including the new-game intro (even if it was skipped).

⚠ For farmhands in multiplayer, this is the value received from the host player the last time they were online when everyone went to sleep.
|-
| <samp>GoatMilkProduced</samp>
| The number of milk items produced by [[goat]]s.

⚠ For farmhands in multiplayer, the value is always zero.
|-
| <samp>SheepWoolProduced</samp>
| The number of wool items produced by [[sheep]].

⚠ For farmhands in multiplayer, the value is always zero.
|-
| <samp>RabbitWoolProduced</samp>
| The number of wool items produced by [[rabbit]]s.

⚠ For farmhands in multiplayer, the value is always zero.
|-
| <samp>ItemsShipped</samp>
| The number of items shipped by any players. See also <samp>CropsShipped</samp>.

⚠ For farmhands in multiplayer, this is the number shipped while they were online to see the end-of-day shipping screen.
|-
| <samp>TrufflesFound</samp>
| The number of truffles found by [[pig]]s.

⚠ For farmhands in multiplayer, the value is always zero.
|}

[[Category:Modding]]