stardew-valley-data 0.29.0 → 0.31.0

package/CHANGELOG.md

@@ -5,6 +5,31 @@ 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.31.0] - 2026-03-29
+
+### Added
+
+- `FishCategory` type added
+  (`'regular' | 'crab-pot' | 'night-market' | 'legendary' | 'legendary-2' | 'other'`)
+- `category: FishCategory` field added to all 77 entries in `data/fish.json`
+- `byCategory(category: FishCategory)` filter method added to `FishQuery`
+- Fish sample script updated to display per-category counts
+- Fish tests updated to cover `byCategory()` across all 6 categories
+
+### Fix
+
+- Added missing Caviar item to the Abandoned Joja Mart bundle in `data/bundles.json`
+
+### Chore
+
+- Bump Dependency Versions
+
+## [0.30.0] - 2026-03-24
+
+### Fix
+
+- Update Farmer Level count to math proper in Perfection Tracker data
+
 ## [0.29.0] - 2026-03-23
 
 ## Added

package/data/bundles.json

@@ -1972,6 +1972,10 @@
         "name": "Void Salmon",
         "quantity": 1,
         "quality": "gold"
+      },
+      {
+        "name": "Caviar",
+        "quantity": 1
       }
     ],
     "itemsRequired": 5,

package/data/fish.json

@@ -4,6 +4,7 @@
     "name": "Pufferfish",
     "description": "Inflates when threatened.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["summer"],
     "location": "Ocean, Ginger Island",
     "weather": "sunny",
@@ -56,6 +57,7 @@
     "name": "Anchovy",
     "description": "A small silver fish found in the ocean.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "fall"],
     "location": "Ocean",
     "weather": "both",
@@ -107,6 +109,7 @@
     "name": "Tuna",
     "description": "A large fish that lives in the ocean.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["summer", "winter"],
     "location": "Ocean, Ginger Island",
     "weather": "both",
@@ -158,6 +161,7 @@
     "name": "Sardine",
     "description": "A common ocean fish.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Ocean",
     "weather": "both",
@@ -215,6 +219,7 @@
     "name": "Bream",
     "description": "A fairly common river fish that becomes active at night.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "River",
     "weather": "both",
@@ -274,6 +279,7 @@
     "name": "Largemouth Bass",
     "description": "A popular fish that lives in lakes.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Mountain Lake",
     "weather": "both",
@@ -336,6 +342,7 @@
     "name": "Smallmouth Bass",
     "description": "A freshwater fish that is very sensitive to pollution.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "fall"],
     "location": "River, Forest Pond",
     "weather": "both",
@@ -395,6 +402,7 @@
     "name": "Rainbow Trout",
     "description": "A freshwater trout with colorful markings.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["summer"],
     "location": "River, Mountain Lake",
     "weather": "sunny",
@@ -434,6 +442,7 @@
     "name": "Salmon",
     "description": "Swims upstream to lay its eggs.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["fall"],
     "location": "River",
     "weather": "both",
@@ -493,6 +502,7 @@
     "name": "Walleye",
     "description": "A freshwater fish caught at night.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["fall", "winter"],
     "location": "River, Mountain Lake, Forest Pond",
     "weather": "rainy",
@@ -558,6 +568,7 @@
     "name": "Perch",
     "description": "A freshwater fish of the winter.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["winter"],
     "location": "River, Mountain Lake, Forest Pond",
     "weather": "both",
@@ -617,6 +628,7 @@
     "name": "Carp",
     "description": "A common pond fish.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall"],
     "location": "Mountain Lake, Secret Woods, Sewers, Mutant Bug Lair",
     "weather": "both",
@@ -648,6 +660,7 @@
     "name": "Catfish",
     "description": "An uncommon fish found in streams.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "fall", "winter"],
     "location": "River, Secret Woods, Witch's Swamp",
     "weather": "rainy",
@@ -679,6 +692,7 @@
     "name": "Pike",
     "description": "A freshwater fish that's difficult to catch.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["summer", "winter"],
     "location": "River, Forest Pond",
     "weather": "both",
@@ -714,6 +728,7 @@
     "name": "Sunfish",
     "description": "A common river fish.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer"],
     "location": "River",
     "weather": "sunny",
@@ -749,6 +764,7 @@
     "name": "Red Mullet",
     "description": "Long ago these were kept as pets.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["summer", "winter"],
     "location": "Ocean",
     "weather": "both",
@@ -800,6 +816,7 @@
     "name": "Herring",
     "description": "A common ocean fish.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "winter"],
     "location": "Ocean",
     "weather": "both",
@@ -831,6 +848,7 @@
     "name": "Eel",
     "description": "A long, slippery little fish.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "fall"],
     "location": "Ocean",
     "weather": "rainy",
@@ -889,6 +907,7 @@
     "name": "Octopus",
     "description": "A mysterious and intelligent creature.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["summer"],
     "location": "Ocean, Ginger Island, Night Market submarine",
     "weather": "both",
@@ -920,6 +939,7 @@
     "name": "Red Snapper",
     "description": "A popular fish with a nice red color.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["summer", "fall", "winter"],
     "location": "Ocean",
     "weather": "rainy",
@@ -971,6 +991,7 @@
     "name": "Squid",
     "description": "A deep sea creature that can grow to enormous size.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["winter"],
     "location": "Ocean",
     "weather": "both",
@@ -1002,6 +1023,7 @@
     "name": "Seaweed",
     "description": "It can be used in cooking.",
     "catchType": "rod",
+    "category": "other",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Ocean",
     "weather": "both",
@@ -1026,6 +1048,7 @@
     "name": "Green Algae",
     "description": "It's really slimy.",
     "catchType": "rod",
+    "category": "other",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "River, Mountain Lake",
     "weather": "both",
@@ -1050,6 +1073,7 @@
     "name": "Sea Cucumber",
     "description": "A slippery, slimy creature found on the ocean floor.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["fall", "winter"],
     "location": "Ocean",
     "weather": "both",
@@ -1102,6 +1126,7 @@
     "name": "Super Cucumber",
     "description": "A rare, purple variety of sea cucumber.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["summer", "winter"],
     "location": "Ocean, Ginger Island",
     "weather": "both",
@@ -1141,6 +1166,7 @@
     "name": "Ghostfish",
     "description": "A pale, blind fish found in underground lakes.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Mines (Floors 20 & 60)",
     "weather": "both",
@@ -1188,6 +1214,7 @@
     "name": "White Algae",
     "description": "It's super slimy.",
     "catchType": "rod",
+    "category": "other",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Mines",
     "weather": "both",
@@ -1212,6 +1239,7 @@
     "name": "Stonefish",
     "description": "A bizarre fish that's shaped like a brick.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Mines (Floor 20)",
     "weather": "both",
@@ -1255,6 +1283,7 @@
     "name": "Crimsonfish",
     "description": "Lives deep in the ocean but likes to lay its eggs in the warm summer water.",
     "catchType": "rod",
+    "category": "legendary",
     "seasons": ["summer"],
     "location": "Ocean",
     "weather": "both",
@@ -1286,6 +1315,7 @@
     "name": "Angler",
     "description": "Uses a bioluminescent dangler to attract prey.",
     "catchType": "rod",
+    "category": "legendary",
     "seasons": ["fall"],
     "location": "River",
     "weather": "both",
@@ -1317,6 +1347,7 @@
     "name": "Ice Pip",
     "description": "A rare fish that thrives in extremely cold conditions.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Mines (Floor 60)",
     "weather": "both",
@@ -1364,6 +1395,7 @@
     "name": "Lava Eel",
     "description": "It can somehow survive in pools of red-hot lava.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Mines (Floor 100), Volcano Caldera",
     "weather": "both",
@@ -1411,6 +1443,7 @@
     "name": "Legend",
     "description": "The king of all fish! They said he'd never be caught.",
     "catchType": "rod",
+    "category": "legendary",
     "seasons": ["spring"],
     "location": "Mountain Lake",
     "weather": "rainy",
@@ -1442,6 +1475,7 @@
     "name": "Sandfish",
     "description": "It tries to hide using camouflage.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Desert",
     "weather": "both",
@@ -1477,6 +1511,7 @@
     "name": "Scorpion Carp",
     "description": "It's like a regular carp but with a sharp stinger.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Desert",
     "weather": "both",
@@ -1513,6 +1548,7 @@
     "name": "Flounder",
     "description": "It lives on the bottom, so both eyes are on top of its head.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer"],
     "location": "Ocean, Ginger Island",
     "weather": "both",
@@ -1548,6 +1584,7 @@
     "name": "Midnight Carp",
     "description": "This shy fish only feels comfortable at night.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["fall", "winter"],
     "location": "Forest Pond, Mountain Lake, Ginger Island",
     "weather": "both",
@@ -1583,6 +1620,7 @@
     "name": "Clam",
     "description": "There's a chewy little guy in there...",
     "catchType": "crab-pot",
+    "category": "crab-pot",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Ocean (crab pot)",
     "sellPrice": 50,
@@ -1647,6 +1685,7 @@
     "name": "Mutant Carp",
     "description": "The strange waters of the sewer turned this carp into a monstrosity.",
     "catchType": "rod",
+    "category": "legendary",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Sewers",
     "weather": "both",
@@ -1678,6 +1717,7 @@
     "name": "Sturgeon",
     "description": "An ancient bottom-feeder with a dwindling population. Females can live up to 150 years.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["summer", "winter"],
     "location": "Mountain Lake",
     "weather": "both",
@@ -1709,6 +1749,7 @@
     "name": "Tiger Trout",
     "description": "A rare hybrid trout that cannot bear offspring of its own.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "River",
     "weather": "both",
@@ -1740,6 +1781,7 @@
     "name": "Bullhead",
     "description": "A relative of the catfish that eats a variety of foods off the lake bottom.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Mountain Lake",
     "weather": "both",
@@ -1795,6 +1837,7 @@
     "name": "Tilapia",
     "description": "A primarily vegetarian fish that prefers warm water.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["summer", "fall"],
     "location": "Ocean",
     "weather": "both",
@@ -1846,6 +1889,7 @@
     "name": "Chub",
     "description": "A common freshwater fish known for its voracious appetite.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "River, Mountain Lake",
     "weather": "both",
@@ -1905,6 +1949,7 @@
     "name": "Dorado",
     "description": "A fierce carnivore with brilliant orange scales.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["summer"],
     "location": "River",
     "weather": "both",
@@ -1940,6 +1985,7 @@
     "name": "Albacore",
     "description": "Prefers temperature 'edges' where cool and warm water meet.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["fall", "winter"],
     "location": "Ocean",
     "weather": "both",
@@ -1991,6 +2037,7 @@
     "name": "Shad",
     "description": "Lives in a school at sea, but returns to the rivers to spawn.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall"],
     "location": "River",
     "weather": "rainy",
@@ -2056,6 +2103,7 @@
     "name": "Lingcod",
     "description": "A fearsome predator that will eat almost anything it can cram into its mouth.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["winter"],
     "location": "River, Mountain Lake",
     "weather": "both",
@@ -2091,6 +2139,7 @@
     "name": "Halibut",
     "description": "A flat fish that lives on the ocean floor.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "winter"],
     "location": "Ocean",
     "weather": "both",
@@ -2142,6 +2191,7 @@
     "name": "Lobster",
     "description": "A large ocean-dwelling crustacean with a strong tail.",
     "catchType": "crab-pot",
+    "category": "crab-pot",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Ocean (crab pot)",
     "sellPrice": 120,
@@ -2206,6 +2256,7 @@
     "name": "Crayfish",
     "description": "A small freshwater relative of the lobster.",
     "catchType": "crab-pot",
+    "category": "crab-pot",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Freshwater (crab pot)",
     "sellPrice": 75,
@@ -2262,6 +2313,7 @@
     "name": "Crab",
     "description": "A marine crustacean with two powerful pincers.",
     "catchType": "crab-pot",
+    "category": "crab-pot",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Ocean (crab pot)",
     "sellPrice": 100,
@@ -2326,6 +2378,7 @@
     "name": "Cockle",
     "description": "A common saltwater clam.",
     "catchType": "crab-pot",
+    "category": "crab-pot",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Ocean (crab pot)",
     "sellPrice": 50,
@@ -2390,6 +2443,7 @@
     "name": "Mussel",
     "description": "A common bivalve that often lives in clusters.",
     "catchType": "crab-pot",
+    "category": "crab-pot",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Ocean (crab pot)",
     "sellPrice": 30,
@@ -2454,6 +2508,7 @@
     "name": "Shrimp",
     "description": "A scavenger that feeds off the ocean floor. Widely prized for its meat.",
     "catchType": "crab-pot",
+    "category": "crab-pot",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Ocean (crab pot)",
     "sellPrice": 60,
@@ -2525,6 +2580,7 @@
     "name": "Snail",
     "description": "A wide-ranging mollusc that lives in a spiral shell.",
     "catchType": "crab-pot",
+    "category": "crab-pot",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Freshwater (crab pot)",
     "sellPrice": 65,
@@ -2581,6 +2637,7 @@
     "name": "Periwinkle",
     "description": "A tiny freshwater snail that lives in a blue shell.",
     "catchType": "crab-pot",
+    "category": "crab-pot",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Freshwater (crab pot)",
     "sellPrice": 20,
@@ -2644,6 +2701,7 @@
     "name": "Oyster",
     "description": "Constantly filters water to find food. In the process, it removes dangerous toxins from the environment.",
     "catchType": "crab-pot",
+    "category": "crab-pot",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Ocean (crab pot)",
     "sellPrice": 40,
@@ -2708,6 +2766,7 @@
     "name": "Woodskip",
     "description": "A very sensitive fish that can only live in pools deep in the forest.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Secret Woods",
     "weather": "both",
@@ -2765,6 +2824,7 @@
     "name": "Glacierfish",
     "description": "Builds a nest on the underside of glaciers.",
     "catchType": "rod",
+    "category": "legendary",
     "seasons": ["winter"],
     "location": "Forest (Arrowhead Island)",
     "weather": "sunny",
@@ -2796,6 +2856,7 @@
     "name": "Void Salmon",
     "description": "A salmon, twisted by void energy. The fresh meat is jet black, but rapidly turns pink when exposed to air.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Witch's Swamp",
     "weather": "both",
@@ -2835,6 +2896,7 @@
     "name": "Slimejack",
     "description": "He's coated in a very thick layer of slime. He keeps slipping out of your hands!",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Mutant Bug Lair",
     "weather": "both",
@@ -2878,6 +2940,7 @@
     "name": "Midnight Squid",
     "description": "A strange and mysterious denizen of the ocean's twilight depths.",
     "catchType": "rod",
+    "category": "night-market",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Night Market submarine",
     "weather": "both",
@@ -2909,6 +2972,7 @@
     "name": "Spook Fish",
     "description": "The huge eyes can detect the faint silhouettes of prey.",
     "catchType": "rod",
+    "category": "night-market",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Night Market submarine",
     "weather": "both",
@@ -2944,6 +3008,7 @@
     "name": "Blobfish",
     "description": "This odd creature floats above the ocean floor, consuming any edible material in its path.",
     "catchType": "rod",
+    "category": "night-market",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Night Market submarine",
     "weather": "both",
@@ -2983,6 +3048,7 @@
     "name": "Stingray",
     "description": "Despite having a toxic stinger, these fish are shy and prefer to avoid humans.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Ginger Island (Pirate Cove)",
     "weather": "both",
@@ -3030,6 +3096,7 @@
     "name": "Lionfish",
     "description": "An aggressive, predatory fish with venomous spines.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Ginger Island",
     "weather": "both",
@@ -3069,6 +3136,7 @@
     "name": "Blue Discus",
     "description": "A brightly colored tropical fish that is popular in aquariums.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Ginger Island (freshwater)",
     "weather": "both",
@@ -3108,6 +3176,7 @@
     "name": "Son of Crimsonfish",
     "description": "He hatched in the warm summer water, and followed in the footsteps of his father.",
     "catchType": "rod",
+    "category": "legendary-2",
     "seasons": ["winter"],
     "location": "Ocean",
     "weather": "both",
@@ -3139,6 +3208,7 @@
     "name": "Ms. Angler",
     "description": "Uses a bioluminescent dangler to attract prey.",
     "catchType": "rod",
+    "category": "legendary-2",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "River",
     "weather": "both",
@@ -3170,6 +3240,7 @@
     "name": "Legend II",
     "description": "The successor to the original Legend.",
     "catchType": "rod",
+    "category": "legendary-2",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Mountain Lake",
     "weather": "rainy",
@@ -3201,6 +3272,7 @@
     "name": "Radioactive Carp",
     "description": "A carp that spent one too many years in toxic sludge.",
     "catchType": "rod",
+    "category": "legendary-2",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Sewers",
     "weather": "both",
@@ -3232,6 +3304,7 @@
     "name": "Glacierfish Jr.",
     "description": "The original Glacierfish had a son...",
     "catchType": "rod",
+    "category": "legendary-2",
     "seasons": ["winter"],
     "location": "Forest (Arrowhead Island)",
     "weather": "sunny",
@@ -3263,6 +3336,7 @@
     "name": "Goby",
     "description": "Some types of Gobies can climb up waterfalls.",
     "catchType": "rod",
+    "category": "regular",
     "seasons": ["spring", "summer", "fall"],
     "location": "Forest (waterfalls)",
     "weather": "both",
@@ -3323,6 +3397,7 @@
     "name": "Sea Jelly",
     "description": "A rare jelly found in the ocean.",
     "catchType": "rod",
+    "category": "other",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Saltwater locations",
     "weather": "both",
@@ -3346,6 +3421,7 @@
     "name": "River Jelly",
     "description": "A rare jelly found in freshwater.",
     "catchType": "rod",
+    "category": "other",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Freshwater locations",
     "weather": "both",
@@ -3369,6 +3445,7 @@
     "name": "Cave Jelly",
     "description": "A rare jelly found in underground lakes.",
     "catchType": "rod",
+    "category": "other",
     "seasons": ["spring", "summer", "fall", "winter"],
     "location": "Mines (levels 20, 60, and 100)",
     "weather": "both",

package/data/perfection.json

@@ -43,7 +43,7 @@
     "id": "farmer-level",
     "name": "Farmer Level",
     "requirement": "Reach level 10 in every skill",
-    "count": 25,
+    "count": 50,
     "unit": "skill levels",
     "weight": 5
   },