Mechanics

Every number on this page is the number the simulation actually uses. The engine is deterministic and open: if a figure here disagrees with the game, the game is right and this page is a bug.

Clock Crops Water, weeds, pests Weather Market Contracts Rule vocabulary Dials and doctrine Heirlooms Land Scoring

The clock

Crops

CropSeedGrowsYieldBaseBest

Base is what one unit fetches when the market holds a normal amount of that crop. Best is base times yield, minus the seed: what one plot returns if you sell into an untouched market, which you will rarely get, because selling moves the price.

Growth time carries a small random variation per planting, so a field planted at once does not ripen all at once. Nothing can be planted so late that it could not ripen before the final bell: the farmhand stops planting near the end of the week rather than burning your coins on seed that will never harvest.

Water, weeds and pests

Weather fronts

Each season runs a sequence of announced fronts. A front changes yields and, in the case of heat and drought, halves how long a crop survives without water.

FrontEffect
โ˜€๏ธ Perfect weekNo modifier
๐Ÿ”ฅ Heat waveReduced yields, crops dry out twice as fast
โ›ˆ๏ธ Storm frontReduced yields
๐Ÿœ๏ธ DroughtSharply reduced yields, crops dry out twice as fast

Fronts are announced ahead of time, so a front is a planning problem, not a punishment. The forecast is public: everyone sees the same one.

The market

One market serves the whole town. Price responds to available supply: the more of a crop that exists, the cheaper it gets, along a curve that differs per crop. Melon is the most sensitive, wheat the least, which is why melon is the crop that rewards timing and punishes dumping.

Because everyone is selling into the same book, the interesting decisions are about other people: what will the town plant, when will they dump, and can you be early or late enough to be paid for it.

Contracts

The farmhand's rule vocabulary

Everything a farmhand can do compiles into a sheet of at most 12 rules drawn from a closed vocabulary. Dials, doctrine cards and plain-language requests are all just different ways of writing this sheet, which is why every season can be replayed and verified by anyone.

sell_threshold(crop, multiple_of_base)

Sell this crop the hour its price reaches the given multiple of its base price. The ask is where the week opens, not a promise: any ask above the floor walks down toward it as the final bell nears, so a patient farm is choosing a better price against fewer hours left to find it.

plant_best(crops, forecast_belief)

On empty ground, plant the crop from this list that the market forecast says will pay best when the plot ripens, weighed against what a seed costs while the coins are short. The second parameter is how far the farmhand leans from the posted price toward that forecast.

take_contracts(max_collateral_fraction, min_premium)

Bid on contracts paying at least this premium over spot, risking at most this fraction of cash as collateral.

cash_floor(coins)

Never spend below this till on planting or contract collateral. Never blocks care or selling.

any rule + when [start_hour, end_hour)

Any rule can carry a time window, which is how time-conditioned intents like "only after day four" are expressed.

Nothing outside this vocabulary executes, ever. A farmhand that proposed arbitrary code would be rejected by the same validator that checks a hand-written sheet.

Dials and doctrine

DialWhat it changes
RiskHow much cash may be committed as contract collateral
PatienceThe asking price the week opens at. Every ask walks down toward its floor as the final bell nears, so patience buys time to find a buyer, not a promise to hold out forever
ContrarianHow far the farmhand trusts the harvest-day forecast over the price on the board today
Cash bufferThe till the farmhand will not spend below
Doctrine cardThe strategy
Contract income firstPrioritize contract income over spot speculation: predictable beats peak
Never hold past harvestSell promptly rather than waiting for a better price
Fade every panicRefuse to sell into a crash in the premium crops, and sell into the recovery instead

You can slot up to three cards. Later rules override earlier ones for the same crop, so doctrine beats temperament where they disagree.

Heirloom strains

A Farmhand NFT carries one heirloom strain, tied to a single crop. Its effect is deliberately one sentence long: that crop ripens sooner, every time you plant it. How much sooner is what the Farmhand's rarity buys.

RarityOf the 4,444Ripens sooner byQuirk
Common2,5981 hourprinted, but inactive
Uncommon1,4942 hoursprinted, but inactive
Rare3092 hourslive
Legendary433 hourslive

What the quirks do

QuirkEffect on its own crop
Deep rootsSurvives 8 hours longer without water
Drought proofHeat and drought fronts do not shorten its water clock
Pest bitterThe town's pest damage does not touch it
GlasshouseWeather cannot touch it at all, the good weeks included
Frost kissedBad weather does half the damage, good weather still helps
Bee charmer+10% harvest
Twin fruit+20% harvest
Long keeper+25% to how much of it you can sell in one hour
Market darling+3% on what it fetches
Night bloomerRipens close to the hour it promised, with half the usual spread
Self seedingSeed costs half
Wild crossThe rarest: the heirloom takes to a second crop as well, the next one along in the table above

Land

Land is the game's main coin sink. Buying it costs score now for capacity later, and capacity is worth nothing if your farmhand cannot keep the extra ground watered.

Scoring and settlement

Start with how to play The whitepaper