Direct data access

When you need raw data arrays without the query builder wrapper, you can import JSON files directly from the stardew-valley-data/data/* export path.

How it works

The package exports its underlying JSON data files through the stardew-valley-data/data/* path. Each import gives you a plain JavaScript array of typed objects -- no query builder, no class instances.

import cropsData from 'stardew-valley-data/data/crops'
import fishData from 'stardew-valley-data/data/fish'

// cropsData is a Crop[] array
console.log(cropsData.length)
console.log(cropsData[0].name)

Available data paths

Every data module has a corresponding JSON file you can import directly:

Farming and nature

Fishing and mining

Characters and social

Combat and equipment

Skills and progression

World and collections

Shops

When to use direct data vs query builders

Use direct data when

• You need the complete dataset and will do your own filtering with Array.filter(), lodash, or similar
• You are feeding data into a framework that expects plain arrays (e.g., a data table component)
• You want to serialize the data to a file or send it over an API
• You are building a custom index or lookup structure

import cropsData from 'stardew-valley-data/data/crops'

// Build your own Map for O(1) lookups
const cropById = new Map(cropsData.map(c => [c.id, c]))

// Use in a data table component
<DataTable rows={cropsData} columns={columns} />

Use query builders when

• You want to filter and sort with readable, chainable method calls
• You need to branch a query into multiple sub-queries
• You want access to convenience methods like findByName() and count()
• You are writing application logic that benefits from the query builder API

import { crops } from 'stardew-valley-data'

const summerRegrowing = crops()
  .bySeason('summer')
  .regrowing()
  .sortBySellPrice('desc')
  .get()

Combining both approaches

You can import raw data and wrap it in a query builder when needed:

import cropsData from 'stardew-valley-data/data/crops'
import { crops } from 'stardew-valley-data'

// Custom pre-filter, then use query builder
const expensive = cropsData.filter((c) => c.cropSellPrice > 200)
const sorted = crops(expensive).sortByGrowDays('asc').get()

Next steps

• Learn about image assets for accessing sprite files
• See the query builder page for the full chainable API