Lily MarketDocumentation
MARKET OPEN
DOCSThe cost model

The cost model

All twelve frogs price an errand the same way. What differs is the margin they demand, the errands they bother with, and how they behave once the auction starts.

The breakdown

Before bidding, a frog computes an expected-value breakdown for the errand: distance + sunlight + congestion risk + opportunity cost + margin. Distance costs 0.22 credits per cell for effort and time. Sunlight is the cells to travel times the frog's drain times the current spot price, so the same ferry costs more when sun is scarce. Congestion risk scales with local crowding around the frog. Opportunity cost rises with the number of open errands but is capped at 2, deliberately mild: if a backlog inflated everyone's floors, the market would spiral (higher floors, fewer wins, deeper backlog).

0 crbid floor 14reward 24
ROOM TO UNDERCUT
  • distance4.219.2 cells × 0.22 cr
  • sunlight3.419.2 cells × 0.052 sun × 3.4 cr/sun
  • congestion risk1.20.3 local crowding × 4
  • opportunity0.6min(2, 4 open errands × 0.15)
  • margin5.0the profit this frog demands
A worked example from the actual formulas: F-03 pricing a 16-cell job with sunlight at 3.4 cr/sun. Its floor is 14 against a 24 credit reward, which leaves 10 credits of room to fight over.

This same breakdown is what the inspector shows on the pond. When you click a frog and see its last bid dissected into five numbers, those are these five terms.

The bid floor

The sum of the five terms, rounded, is the frog's maxRationalBid: the lowest payment it will accept, clamped so it never exceeds the reward. Two personalities bend the rule. The aggressor shaves one credit off its floor to win ties. The gambler multiplies its floor by random noise of roughly ±30%, which means it sometimes bids below its own cost and takes a real loss. That mispricing is intentional; a market with only rational actors is less interesting to watch and less honest as an experiment.

Who shows up

Entering an auction at all is a decision. One rule is hard for everyone: the frog must have enough stamina to finish the job and still reach a basking stone, with 14 cells of slack. Past that, each strategy has its own filter.

STRATEGYENTERS THE AUCTION WHEN
courierthe total trip is 26 cells or less. Short hops only.
steadystamina is above 35% and the local lanes are not crowded.
haulerthe reward is at least 22 credits, or the ferry is at least 12 cells.
sniperat least 55% of the auction window has already passed.
miserstamina is above 45%, unless the reward is 30 or more.
gamblera dice roll says so. It skips about 15% of errands at random.
aggressor, learneralways, as long as the stamina constraint holds.

Undercut style

Once in, personalities differ in how hard they push. The aggressor undercuts by 3 credits per round, couriers by 2, the steady and miser types by a cautious 1. The gambler flips between 3 and 1. A bigger step wins more races to the bottom but leaves money on the table when a smaller one would have been enough.

The learner

F-03 is the one frog whose margin is not fixed. It starts at 5 credits and moves with results: each win relaxes it by 0.4 (up to 10), each loss tightens it by 0.6 (down to 1). Over a long session it drifts toward whatever margin the market will actually bear, which makes it a decent live estimate of the clearing price of frog labor.