Lily MarketDocumentation
MARKET OPEN
DOCSThe colony

The colony

Twelve frogs, eight strategies, every one hand-written and readable. Interpretable on purpose. RL comes later.

The roster

This table renders from src/sim/robots.ts, the same file the engine loads, so it cannot drift from the code. Speed is in cells per second, drain in sun per cell.

IDROLESPEEDSTAMINADRAINMIN MARGINBASKS AT
F-01QUICK COURIER3.4 c/s9 sun0.055 sun/c4 cr28%
F-02RISK AVERSE2.6 c/s12 sun0.05 sun/c7 cr40%
F-03LEARNING AGENT2.9 c/s10 sun0.052 sun/c5 cr32%
F-04HEAVY CARRIER2 c/s16 sun0.075 sun/c8 cr30%
F-07AGGRESSIVE BIDDER3.1 c/s9 sun0.06 sun/c2 cr22%
F-09OPPORTUNIST3 c/s10 sun0.055 sun/c6 cr30%
F-12ENERGY SAVER2.4 c/s11 sun0.042 sun/c6 cr50%
F-15NOISE TRADER2.8 c/s10 sun0.058 sun/c3 cr26%
F-16QUICK COURIER3.3 c/s9 sun0.056 sun/c5 cr30%
F-19RISK AVERSE2.5 c/s13 sun0.05 sun/c7 cr42%
F-21AGGRESSIVE BIDDER3 c/s9 sun0.06 sun/c2 cr24%
F-23ENERGY SAVER2.3 c/s12 sun0.04 sun/c6 cr52%
The cast. Symbol and color match what you see on the pond and in every chart.

Personalities

A strategy shapes three decisions: which auctions to enter, how low to go, and how hard to undercut. The exact rules live on the cost model page; this is who they add up to.

STRATEGYIN ONE LINE
courierFast and small. Takes short hops only and turns them over quickly.
steadyRisk averse. Sits out when stamina is low or the lanes are crowded, and demands a fat margin.
learnerThe adaptive one. Its margin floats with wins and losses, tracking the market's clearing price.
haulerSlow, deep reserves, burns sun fast. Only long or well-paid jobs are worth its while.
aggressorBids on everything, undercuts hard, accepts 2 credit margins. Volume over price.
sniperWaits out half the window, then bids into whatever spread is left.
miserWeights sunlight 1.6x in its cost model and basks early. Slow, cheap to run, patient.
gamblerThe noise trader. Random entries, noisy floors, sometimes a genuine loss-making bid.

Careers

Every frog starts with 100 credits and a reputation of 80. Deliveries pay the winning bid and add half a point of reputation; a failure costs a 5 credit fine and 4 points. On top of that sit the career stats: errands completed and failed, auctions won and lost, lifetime earnings, lifetime sunlight spend, and a balance history sampled every two seconds.

The /frogs page ranks the colony by balance and opens a career panel per frog. The spread you see there is the point of the whole sim: identical rules, very different bank accounts. The market desk tracks that inequality as a Gini coefficient.