stardew-valley-data 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -5,6 +5,12 @@ 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).
 
+## [v0.4.0] - 2026-03-15
+
+### Breaking Changes
+
+- Change many of the output modules for parsing the file.
+
 ## [v0.3.0] - 2026-03-15
 
 ### Fix

package/README.md

@@ -12,6 +12,12 @@
 
 ---
 
+> **Pre-1.0 Notice:** This package is under active development. Breaking changes to the save file
+> parser structure, data types, and other APIs may occur in any release before `1.0.0`. Pin your
+> version or review the [Change Log](CHANGELOG.md) before upgrading.
+
+---
+
 ## 📦 Installation
 
 ```bash

package/dist/index.d.mts

@@ -2506,12 +2506,24 @@ interface SavePlayer {
     totalMoneyEarned: number;
     spouse: string | null;
     houseUpgradeLevel: number;
+    luckLevel: number;
+    maxItems: number;
     maxHealth: number;
     maxStamina: number;
     skills: SaveSkills;
     mastery: SaveMastery;
+    toolLevels: SaveToolLevels;
     gameVersion: string;
 }
+/** Upgrade levels for the player's tools (0 = base, 1 = copper, 2 = steel, 3 = gold, 4 = iridium). */
+interface SaveToolLevels {
+    wateringCan: number;
+    pan: number;
+    pickaxe: number;
+    axe: number;
+    hoe: number;
+    trashCan: number;
+}
 /** Mastery system progress including XP, levels spent, and unlocked perks. */
 interface SaveMastery {
     xp: number;
@@ -2592,6 +2604,7 @@ interface SaveAnimal {
     id: string;
     name: string;
     type: string;
+    buildingId: string;
     buildingType: string;
     friendship: number;
     happiness: number;
@@ -2600,9 +2613,8 @@ interface SaveAnimal {
 }
 /** A farm building with its type, position, and current animal count. */
 interface SaveBuilding {
+    id: string;
     type: string;
-    tileX: number;
-    tileY: number;
     animalCount: number;
 }
 /** An active or completed quest with its title, description, and completion status. */
@@ -2624,9 +2636,8 @@ interface SaveRecipeEntry {
     name: string;
     timesMade: number;
 }
-/** Community Center bundle data including all bundles, room summaries, and Joja route status. */
+/** Community Center bundle data including rooms with nested bundles and Joja route status. */
 interface SaveBundleData {
-    bundles: SaveBundleStatus[];
     rooms: SaveBundleRoom[];
     isJojaRoute: boolean;
     isCCComplete: boolean;
@@ -2640,9 +2651,9 @@ interface SaveBundleRoom {
 }
 /** A single bundle with its required items, completion progress, and reward. */
 interface SaveBundleStatus {
+    id: string;
     bundleIndex: number;
     name: string;
-    room: string;
     items: SaveBundleItem[];
     itemsRequired: number;
     itemsCompleted: number;
@@ -2678,7 +2689,6 @@ interface SaveProfession {
 /** Completed special orders split by town board and Qi's Walnut Room. */
 interface SaveSpecialOrders {
     completed: string[];
-    townCompleted: string[];
     qiCompleted: string[];
 }
 /** Secret notes and journal scraps found, plus magnifying glass ownership. */
@@ -2686,6 +2696,7 @@ interface SaveSecretNotes {
     notesFound: number[];
     journalScrapsFound: number[];
     hasMagnifyingGlass: boolean;
+    hasSeenKrobus: boolean;
 }
 /** Golden walnut collection progress with total found and tracker entries. */
 interface SaveWalnuts {

package/dist/index.d.ts

@@ -2506,12 +2506,24 @@ interface SavePlayer {
     totalMoneyEarned: number;
     spouse: string | null;
     houseUpgradeLevel: number;
+    luckLevel: number;
+    maxItems: number;
     maxHealth: number;
     maxStamina: number;
     skills: SaveSkills;
     mastery: SaveMastery;
+    toolLevels: SaveToolLevels;
     gameVersion: string;
 }
+/** Upgrade levels for the player's tools (0 = base, 1 = copper, 2 = steel, 3 = gold, 4 = iridium). */
+interface SaveToolLevels {
+    wateringCan: number;
+    pan: number;
+    pickaxe: number;
+    axe: number;
+    hoe: number;
+    trashCan: number;
+}
 /** Mastery system progress including XP, levels spent, and unlocked perks. */
 interface SaveMastery {
     xp: number;
@@ -2592,6 +2604,7 @@ interface SaveAnimal {
     id: string;
     name: string;
     type: string;
+    buildingId: string;
     buildingType: string;
     friendship: number;
     happiness: number;
@@ -2600,9 +2613,8 @@ interface SaveAnimal {
 }
 /** A farm building with its type, position, and current animal count. */
 interface SaveBuilding {
+    id: string;
     type: string;
-    tileX: number;
-    tileY: number;
     animalCount: number;
 }
 /** An active or completed quest with its title, description, and completion status. */
@@ -2624,9 +2636,8 @@ interface SaveRecipeEntry {
     name: string;
     timesMade: number;
 }
-/** Community Center bundle data including all bundles, room summaries, and Joja route status. */
+/** Community Center bundle data including rooms with nested bundles and Joja route status. */
 interface SaveBundleData {
-    bundles: SaveBundleStatus[];
     rooms: SaveBundleRoom[];
     isJojaRoute: boolean;
     isCCComplete: boolean;
@@ -2640,9 +2651,9 @@ interface SaveBundleRoom {
 }
 /** A single bundle with its required items, completion progress, and reward. */
 interface SaveBundleStatus {
+    id: string;
     bundleIndex: number;
     name: string;
-    room: string;
     items: SaveBundleItem[];
     itemsRequired: number;
     itemsCompleted: number;
@@ -2678,7 +2689,6 @@ interface SaveProfession {
 /** Completed special orders split by town board and Qi's Walnut Room. */
 interface SaveSpecialOrders {
     completed: string[];
-    townCompleted: string[];
     qiCompleted: string[];
 }
 /** Secret notes and journal scraps found, plus magnifying glass ownership. */
@@ -2686,6 +2696,7 @@ interface SaveSecretNotes {
     notesFound: number[];
     journalScrapsFound: number[];
     hasMagnifyingGlass: boolean;
+    hasSeenKrobus: boolean;
 }
 /** Golden walnut collection progress with total found and tracker entries. */
 interface SaveWalnuts {

package/dist/index.js

@@ -33376,6 +33376,7 @@ function parseAnimals(root) {
           id: str(fa.myID),
           name: str(fa.name),
           type: str(fa.type),
+          buildingId: str(b.id),
           buildingType: str(fa.buildingTypeILiveIn),
           friendship: num(fa.friendshipTowardFarmer),
           happiness: num(fa.happiness),
@@ -33400,9 +33401,8 @@ function parseBuildings(root) {
     for (const building of buildings2) {
       const b = building;
       result.push({
+        id: str(b.id),
         type: str(b.buildingType),
-        tileX: num(b.tileX),
-        tileY: num(b.tileY),
         animalCount: num(b.currentOccupants)
       });
     }
@@ -33600,9 +33600,9 @@ function parseBundles(root, mail) {
     });
     const itemsCompleted = items.filter((it) => it.completed).length;
     bundles2.push({
+      id: `${def.room}/${index}`,
       bundleIndex: index,
       name: def.name,
-      room: def.room,
       items,
       itemsRequired: def.itemsRequired,
       itemsCompleted,
@@ -33630,7 +33630,7 @@ function parseBundles(root, mail) {
   rooms.sort((a, b) => a.areaIndex - b.areaIndex);
   const isJojaRoute = JOJA_MAIL_FLAGS.some((f) => mail.has(f));
   const isCCComplete = mail.has("ccIsComplete");
-  return { bundles: bundles2, rooms, isJojaRoute, isCCComplete };
+  return { rooms, isJojaRoute, isCCComplete };
 }
 
 // src/save-file/parsers/v1/date.ts
@@ -33791,9 +33791,8 @@ function parseMail(mailReceived) {
 }
 function parseSpecialOrders(root) {
   const completed = ensureArray(root.completedSpecialOrders?.string).map((m) => str(m)).filter(Boolean);
-  const townCompleted = completed.filter((id) => !QI_ORDER_IDS.has(id));
   const qiCompleted = completed.filter((id) => QI_ORDER_IDS.has(id));
-  return { completed, townCompleted, qiCompleted };
+  return { completed, qiCompleted };
 }
 function parseBooksRead(player) {
   const books = [];
@@ -33957,6 +33956,67 @@ function parseMastery(stats) {
     perks
   };
 }
+var TOOL_TYPES = ["WateringCan", "Pan", "Pickaxe", "Axe", "Hoe"];
+var TOOL_KEY_MAP = {
+  WateringCan: "wateringCan",
+  Pan: "pan",
+  Pickaxe: "pickaxe",
+  Axe: "axe",
+  Hoe: "hoe"
+};
+function collectToolItems(node, depth = 0) {
+  if (!node || typeof node !== "object" || depth > 20) return [];
+  const results = [];
+  if (Array.isArray(node)) {
+    for (const child of node) results.push(...collectToolItems(child, depth + 1));
+    return results;
+  }
+  const obj = node;
+  const xsiType = obj["@_xsi:type"] ?? obj["@_type"] ?? "";
+  if (TOOL_TYPES.includes(xsiType)) {
+    results.push(obj);
+  }
+  for (const key of [
+    "Item",
+    "items",
+    "objects",
+    "item",
+    "Object",
+    "value",
+    "GameLocation",
+    "Building",
+    "buildings",
+    "indoors",
+    "heldObject"
+  ]) {
+    if (obj[key]) results.push(...collectToolItems(obj[key], depth + 1));
+  }
+  return results;
+}
+function parseToolLevels(player, root) {
+  const levels = {
+    wateringCan: 0,
+    pan: 0,
+    pickaxe: 0,
+    axe: 0,
+    hoe: 0,
+    trashCan: num(player.trashCanLevel)
+  };
+  const allItems2 = [
+    ...collectToolItems(player.items),
+    ...collectToolItems(root.locations?.GameLocation)
+  ];
+  for (const item of allItems2) {
+    const i = item;
+    const xsiType = i["@_xsi:type"] ?? i["@_type"] ?? "";
+    const key = TOOL_KEY_MAP[xsiType];
+    if (key) {
+      const level = num(i.upgradeLevel);
+      if (level > levels[key]) levels[key] = level;
+    }
+  }
+  return levels;
+}
 function parsePlayer(player, root) {
   return {
     name: str(player.name),
@@ -33967,10 +34027,13 @@ function parsePlayer(player, root) {
     totalMoneyEarned: num(player.totalMoneyEarned),
     spouse: player.spouse ? str(player.spouse) : null,
     houseUpgradeLevel: num(player.houseUpgradeLevel),
+    luckLevel: num(player.luckLevel),
+    maxItems: num(player.maxItems),
     maxHealth: num(player.maxHealth),
     maxStamina: num(player.maxStamina),
     skills: parseSkills(player.experiencePoints?.int),
     mastery: parseMastery(player.stats),
+    toolLevels: parseToolLevels(player, root),
     gameVersion: str(root.gameVersion)
   };
 }
@@ -34063,12 +34126,13 @@ function parseCraftingRecipes(data) {
 }
 
 // src/save-file/parsers/v1/secret-notes.ts
-function parseSecretNotes(player, mail) {
+function parseSecretNotes(player, mail, events2) {
   const allNotes = ensureArray(player.secretNotesSeen?.int).map(num);
   return {
     notesFound: allNotes.filter((n) => n < 1e3),
     journalScrapsFound: allNotes.filter((n) => n >= 1e3).map((n) => n - 1e3),
-    hasMagnifyingGlass: mail.has("HasMagnifyingGlass") || player.hasMagnifyingGlass === true || player.hasMagnifyingGlass === "true"
+    hasMagnifyingGlass: mail.has("HasMagnifyingGlass") || player.hasMagnifyingGlass === true || player.hasMagnifyingGlass === "true",
+    hasSeenKrobus: events2.has("520702")
   };
 }
 
@@ -34162,7 +34226,7 @@ var v1 = (ctx) => ({
   professions: parseProfessions(ctx.player.professions),
   booksRead: parseBooksRead(ctx.player),
   eventsSeen: ctx.eventsSeen,
-  secretNotes: parseSecretNotes(ctx.player, ctx.mailSet),
+  secretNotes: parseSecretNotes(ctx.player, ctx.mailSet, ctx.eventsSet),
   walnuts: parseWalnuts(ctx.root),
   islandUpgrades: parseIslandUpgrades(ctx.mailSet),
   children: parseChildren(ctx.root),