stardew-valley-data 0.23.0 → 0.24.0

package/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project
 adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.24.0] - 2026-03-22
+
+### Added
+
+- `parseFishPonds()` parser added — new `fishPonds` field on `SaveData` extracting fish pond
+  buildings with `buildingId`, `fishType` (item ID), `currentOccupants`, and `maxOccupants`
+- `SaveFishPond` interface added to save file types
+
 ## [0.23.0] - 2026-03-22
 
 ### Added

package/dist/index.d.mts

@@ -2637,6 +2637,7 @@ interface SaveData {
     stardrops: SaveStardropEntry[];
     stats: SaveStats;
     animals: SaveAnimal[];
+    fishPonds: SaveFishPond[];
     buildings: SaveBuilding[];
     cookingRecipes: SaveRecipeEntry[];
     craftingRecipes: SaveRecipeEntry[];
@@ -2777,6 +2778,13 @@ interface SaveAnimal {
     age: number;
     hasAnimalCracker: boolean;
 }
+/** A fish pond building with the fish species and population. */
+interface SaveFishPond {
+    buildingId: string;
+    fishType: number;
+    currentOccupants: number;
+    maxOccupants: number;
+}
 /** A farm building with its type, position, and current animal count. */
 interface SaveBuilding {
     id: string;

package/dist/index.d.ts

@@ -2637,6 +2637,7 @@ interface SaveData {
     stardrops: SaveStardropEntry[];
     stats: SaveStats;
     animals: SaveAnimal[];
+    fishPonds: SaveFishPond[];
     buildings: SaveBuilding[];
     cookingRecipes: SaveRecipeEntry[];
     craftingRecipes: SaveRecipeEntry[];
@@ -2777,6 +2778,13 @@ interface SaveAnimal {
     age: number;
     hasAnimalCracker: boolean;
 }
+/** A fish pond building with the fish species and population. */
+interface SaveFishPond {
+    buildingId: string;
+    fishType: number;
+    currentOccupants: number;
+    maxOccupants: number;
+}
 /** A farm building with its type, position, and current animal count. */
 interface SaveBuilding {
     id: string;

package/dist/index.js

@@ -40660,6 +40660,33 @@ function parseAnimals(root) {
   }
   return result;
 }
+function parseFishPonds(root) {
+  const result = [];
+  const locations2 = ensureArray(root.locations?.GameLocation);
+  for (const loc of locations2) {
+    const l = loc;
+    if (str(l.name) !== "Farm") continue;
+    const buildings2 = ensureArray(l.buildings?.Building);
+    for (const building of buildings2) {
+      const b = building;
+      const xsiType = str(
+        b["@_xsi:type"] ?? b["@_type"]
+      );
+      if (xsiType !== "FishPond") continue;
+      const fishTypeRaw = b.fishType;
+      const fishType = num(fishTypeRaw?.int);
+      if (fishType === 0) continue;
+      result.push({
+        buildingId: str(b.id),
+        fishType,
+        currentOccupants: num(b.currentOccupants),
+        maxOccupants: num(b.maxOccupants)
+      });
+    }
+    break;
+  }
+  return result;
+}
 
 // src/save-file/parsers/v1/buildings.ts
 function parseBuildings(root) {
@@ -41566,6 +41593,7 @@ var v1 = (ctx) => ({
   stardrops: parseStardrops(ctx.player.mailReceived),
   stats: parseStats(ctx.player),
   animals: parseAnimals(ctx.root),
+  fishPonds: parseFishPonds(ctx.root),
   buildings: parseBuildings(ctx.root),
   cookingRecipes: parseCookingRecipes(ctx.player.cookingRecipes, ctx.player.recipesCooked),
   craftingRecipes: parseCraftingRecipes(ctx.player.craftingRecipes),