Quality calculator

The quality calculator computes sell prices and energy/health values for Silver, Gold, and Iridium quality items, matching the game's internal formulas.

Basic usage

Import qualityCalculator and call its methods with base values:

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

const calc = qualityCalculator()

// Calculate sell prices for an item worth 250g base
const prices = calc.sellPrices(250)
// [
//   { quality: 'silver', icon: 'images/misc/Silver Quality.png', value: 312 },
//   { quality: 'gold',   icon: 'images/misc/Gold Quality.png',   value: 375 },
//   { quality: 'iridium', icon: 'images/misc/Iridium Quality.png', value: 500 }
// ]

The qualityCalculator() function

function qualityCalculator(): QualityCalculator

Returns a QualityCalculator instance. The instance provides two methods: sellPrices() and energyHealth().

sellPrices(basePrice)

Calculates the sell price for each quality tier using the game's formula: Math.floor(basePrice * multiplier).

sellPrices(basePrice: number): QualityPrice[]

Parameters

Returns

An array of three QualityPrice objects, one for each quality tier.

Quality sell price multipliers

Example

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

const calc = qualityCalculator()
const melon = crops().findByName('Melon')

if (melon) {
  const prices = calc.sellPrices(melon.cropSellPrice)
  console.log(`Melon base price: ${melon.cropSellPrice}g`)
  prices.forEach((p) => {
    console.log(`  ${p.quality}: ${p.value}g`)
  })
}

energyHealth(baseEnergy, baseHealth)

Calculates the energy and health restoration values for each quality tier. Uses different multipliers than sell prices.

energyHealth(baseEnergy: number, baseHealth: number): QualityEnergyHealth[]

Parameters

Returns

An array of three QualityEnergyHealth objects, one for each quality tier.

Quality energy/health multipliers

Example

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

const calc = qualityCalculator()
const crop = crops().findByName('Melon')

if (crop?.energyHealth) {
  const { energy, health } = crop.energyHealth
  if (energy !== undefined && health !== undefined) {
    const stats = calc.energyHealth(energy, health)
    console.log(`Melon base: ${energy} energy, ${health} health`)
    stats.forEach((s) => {
      console.log(`  ${s.quality}: ${s.energy} energy, ${s.health} health`)
    })
  }
}

Return types

QualityPrice

interface QualityPrice {
  quality: Quality // 'silver' | 'gold' | 'iridium'
  icon: string // Path to quality icon image
  value: number // Calculated sell price (floored)
}

QualityEnergyHealth

interface QualityEnergyHealth {
  quality: Quality // 'silver' | 'gold' | 'iridium'
  icon: string // Path to quality icon image
  energy: number // Calculated energy value (floored)
  health: number // Calculated health value (floored)
}

Both types include an icon field with the path to the quality tier's icon image:

Practical examples

Price comparison table

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

const calc = qualityCalculator()

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

for (const crop of summerCrops.slice(0, 5)) {
  const prices = calc.sellPrices(crop.cropSellPrice)
  const iridiumPrice = prices.find((p) => p.quality === 'iridium')!.value
  console.log(
    `${crop.name}: ${crop.cropSellPrice}g base, ${iridiumPrice}g iridium`,
  )
}

Displaying quality prices in a UI

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

function QualityPrices({ basePrice }: { basePrice: number }) {
  const prices = qualityCalculator().sellPrices(basePrice)

  return (
    <div>
      <span>Base: {basePrice}g</span>
      {prices.map((p) => (
        <span key={p.quality}>
          <img
            src={`/stardew-images/${p.icon.replace('images/', '')}`}
            alt={p.quality}
          />
          {p.value}g
        </span>
      ))}
    </div>
  )
}

Combined price and energy display

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

const calc = qualityCalculator()

function getItemQualityStats(
  basePrice: number,
  baseEnergy: number,
  baseHealth: number,
) {
  const prices = calc.sellPrices(basePrice)
  const stats = calc.energyHealth(baseEnergy, baseHealth)

  return prices.map((price, i) => ({
    quality: price.quality,
    icon: price.icon,
    sellPrice: price.value,
    energy: stats[i].energy,
    health: stats[i].health,
  }))
}

const melonStats = getItemQualityStats(250, 113, 50)
melonStats.forEach((s) => {
  console.log(
    `${s.quality}: ${s.sellPrice}g, ${s.energy} energy, ${s.health} health`,
  )
})

artisanCalculator()

function artisanCalculator(): ArtisanCalculator

Calculates sell prices and energy/health values for artisan goods. Each method takes the base values of the source ingredient.

Methods

Return types

interface ArtisanResult {
  sellPrice: number
}

interface ArtisanEnergyResult {
  sellPrice: number
  energy: number
  health: number
}

Example

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

const calc = artisanCalculator()
const melon = crops().findByName('Melon')

if (melon) {
  const wine = calc.wine(
    melon.cropSellPrice,
    melon.energyHealth!.energy,
    melon.energyHealth!.health,
  )
  console.log(`Melon Wine: ${wine.sellPrice}g, ${wine.energy} energy`)

  const jelly = calc.jelly(
    melon.cropSellPrice,
    melon.energyHealth!.energy,
    melon.energyHealth!.health,
  )
  console.log(`Melon Jelly: ${jelly.sellPrice}g`)
}

professionCalculator()

function professionCalculator(): ProfessionCalculator

Calculates sell prices with profession bonuses applied. Each method takes a base sell price and returns the adjusted value.

Methods

All results are Math.floored.

Example

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

const calc = professionCalculator()
const parsnip = crops().findByName('Parsnip')

if (parsnip) {
  const base = parsnip.cropSellPrice
  console.log(`Base: ${base}g`)
  console.log(`Tiller: ${calc.tiller(base)}g`)
  console.log(`Artisan (pickles): ${calc.artisan(calc.tiller(base))}g`)
}

knowledgeCalculator()

function knowledgeCalculator(): KnowledgeCalculator

Calculates sell prices with special knowledge bonuses (Bear's Knowledge, Spring Onion Mastery).

Methods

Example

import { knowledgeCalculator, forageables } from 'stardew-valley-data'

const calc = knowledgeCalculator()
const springOnion = forageables().findByName('Spring Onion')

if (springOnion) {
  console.log(`Base: ${springOnion.sellPrice}g`)
  console.log(
    `With mastery: ${calc.springOnionMastery(springOnion.sellPrice)}g`,
  )
}

jojaParrotCalculator()

function jojaParrotCalculator(): JojaParrotCalculator

Calculates the gold cost to purchase remaining Golden Walnuts from the Joja Parrot. Each unfound walnut costs 10,000g, and all remaining walnuts are delivered after sleeping.

Methods & getters

Example

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

const calc = jojaParrotCalculator()
const found = 87

console.log(`Total walnuts: ${calc.total}`)
console.log(`Walnuts remaining: ${calc.remaining(found)}`)
console.log(`Cost to buy all remaining: ${calc.cost(found).toLocaleString()}g`)

Next steps

• Learn about the search utility for finding items across all modules
• See image assets for using quality icons in your UI
• Explore TypeScript integration for the Quality, QualityPrice, and QualityEnergyHealth types