lofts materials economy — dev notes

generated 2026-07-27 · v11 scale (pre-reprice: divide coins by 10, quantities unchanged) · internal

Attachments: materials-cost-sheet.md (all numbers) · full plan only if you want the reasoning

The ask

Reply with rough sizing per drop (S/M/L/XL each). Calendar comes from your numbers. Push back on anything.

3 drops. Coin prices unchanged — material baskets stack on top.

D1: comfort score + ambience + worker meal scenes (cosmetic). Zero economy changes.
D2: new crop WILLOW_WOOD + construction baskets + blueprint/staged builds.
D3: wages → food upkeep + machine upkeep trickle + 12h unattended cap.

Slot-level comfort score in lofts_progress. Recompute ONLY on events (furniture place/remove, join). No tick loop.
Sources: furniture points by group + decor variety (tables in sheet). Bands: 0.9x / 1.0x / 1.1x / 1.2x worker speed only — never enters contract/market payout multiplier stacks.
Credit furniture counts (owner signed).
Cozy+ ambience: particles + occasional note sounds. Meal scenes: workers path to table + eat on schedule, cosmetic until D3.

WILLOW_WOOD: custom item, bamboo-style stacked crop. grow 7200s / serviced 1250s / yield 4 per stack / sell 90 (v11). Worst $/hr in game by design (~22% of wheat per plot-hr).
Harvest fx: particles + timber sound + one-time first-harvest toast.
Baskets on every buildable: tiers, rooms, garden f2–f4, floors, machines, silo. Full table in sheet.
Blueprint flow: ghost preview → confirm → staged layered paste. Preview = BlockDisplay on Java, particle outline + title on Bedrock.
/economy gets a Materials tab.
Stockpile protection ships here — mechanism is your call (below).

Wages removed. Outstanding prepay refunded as coins, one-time, audited.
Lunchbox: 24h buffer per worker. 2 meal-equiv per worker-hr (1 meal = 1 BREAD of value). FOOD-class list + meal values in sheet. Raw crops count at 50%.
Draw order: round-robin across the 2 cheapest distinct foods (base productValue per meal-equiv, never live market price, ties by item ID).
Hungry worker: naps at bed, visible state, no debt, feed to resume.
Machine upkeep: 2 wood + 200 coins per machine-hr while processing. No wood = machine pauses (defined state, no crash).
12h unattended-production cap, all 3 worker types, activity-based (AFK-online = offline). offlineFarmerCatchupHours only covers farmers by name — extend it or add per-type keys.

Stockpile protection — pick one: (a) per-item never-auto-sell lock toggle, commit just checks stock; (b) escrow/earmark at blueprint confirm. Whichever you can make structurally safe.
Staged-build concurrency — pastes are the heaviest op; 07-09 audit logged 551ms main-thread stalls at 11 players. Suggestion: serialize + FIFO + "crew busy" message. Your call.
Rollback — if you do kill-switches: construction-off = coin-only, upkeep-off = wages resume, comfort-off = 1.0x.

All numbers in config.yml, not jar constants. Sheet is script-generated; regen on retune, never hand-edit.
Baskets acyclic: no basket may contain an item whose only faucet is gated behind that buildable.
Commit atomic: coins + basket all-or-nothing. One pending blueprint per slot+buildable. Cancel can't race commit. Crash mid-build = resume or refund, never both, never neither.
Bedrock/Floodgate fallback per feature. No BlockDisplay reliance.

economyVersion is 14 now (v11 spec assumed 10) — what do the bumps contain, what migration fires on a bump?
Can we get a jar↔config version gate so partial deploys fail loud?
Anything else on the XConomy MySQL? Any $-denominated columns besides wallets?

Generated by gen-cost-sheet.py. Dial: materialShare = 0.4.

Pre-v11 servers: divide coin/value figures by 10; quantities unchanged.

Property	Value
Player-tended grow time	7200s (matches bamboo)
Farmer-serviced time	1250s
Yield per mature stack	4 WILLOW_WOOD
Sell value (NPC floor, never buyable)	90 each
Plant price	300
$/plot-hr serviced	1,037 = 21.6% of wheat (invariant: 20-25%) PASS
Basket parity value (conversion only)	417/wood (wheat plot-hr parity)
Protection	protected from all automatic drains by default from ship

Buildable	v11 coins	Basket	Basket value	Willow plot-hrs
Garden f1 (unlock)	0	—	0	0.0
Garden f2	50,000	48 WILLOW_WOOD	20,000	4.2
Garden f3	350,000	336 WILLOW_WOOD	140,000	29.2
Garden f4	2,000,000	1920 WILLOW_WOOD	800,000	166.7
Processing room	7,500	30 WILLOW_WOOD	3,000	2.6
Bakery room	0	25 WILLOW_WOOD + 10 FLOUR	0	2.2
Apiary room	60,000	35 WILLOW_WOOD + 7 WAX	24,000	3.0
Rocket silo	1,000,000	480 WILLOW_WOOD + 7 COAL + 12 CACTUS_FIBER (or 6 BAMBOO_FIBER)	400,000	41.7
Machine: Mixer	5,000	10 WILLOW_WOOD	2,000	0.9
Machine: Oven	20,000	12 WILLOW_WOOD + 1 COAL	8,000	1.0
Machine: Refinery	100,000	58 WILLOW_WOOD + 12 WAX	40,000	5.0
Machine: Press	550,000	264 WILLOW_WOOD + 4 COAL + 7 CACTUS_FIBER (or 3 BAMBOO_FIBER)	220,000	22.9

Upgrade	v11 coins	Wood	Era food (representative)	Willow plot-hrs
T1→T2	50,000	24 WILLOW_WOOD	6 BREAD	2.1
T2→T3	100,000	48 WILLOW_WOOD	11 BREAD	4.2
T3→T4	200,000	96 WILLOW_WOOD	22 BREAD	8.3
T4→T5	400,000	192 WILLOW_WOOD	5 PUMPKIN_PIE	16.7
T5→T6	800,000	384 WILLOW_WOOD	10 PUMPKIN_PIE	33.3
T6→T7	1,600,000	768 WILLOW_WOOD	20 PUMPKIN_PIE	66.7
T7→T8	3,200,000	1,536 WILLOW_WOOD	42 FIBER_CRACKER	133.3
T8→T9	6,400,000	3,072 WILLOW_WOOD	85 FIBER_CRACKER	266.7
T9→T10	12,800,000	6,144 WILLOW_WOOD	2,560,000 value in T9-10 goods (LIVE VALUES — Rob fills from jar catalog: NETHER_LOAF, SUNBLOSSOM_TART, PITCHER_PRESERVE)	533.3

Plot-hrs column is the visibility the review asked for in place of a hard cap — Rob sees every wall's size before shipping it.

Consumption: 2 meals per worker-hour (1 meal = 1,800 value = 1 BREAD). Lunchbox depth 24h.
Wage context: removed wage was 1,200/hr (v11); food upkeep ≈ 3,600/hr in goods — richer than the wage on purpose: food is production, not a tax.
One wheat plot (serviced) → 24 wheat/hr → 8 bread/hr via mill+oven → feeds 4 workers.
Raw crops count at 50% meal value (onboarding path).

Per machine-hour while processing: 2 WILLOW_WOOD + 200 coins (v11).
Out of wood: machine pauses with a visible state — defined stall, no crash (verification checklist, drop 3).

Decor variety: +2 per distinct group present (max +10). Credit furniture: same points by group (owner-signed pay-for-advantage).