16. Balancing
Every formula, every tunable constant, and the pacing model.
このページはまだ日本語に翻訳されていません。
Every formula and tunable constant is here, with the checks that hold balance in place.
Source of truth. The build is normative: every number below is checked against the catalog in
packages/simulation/src/catalog at the build this page ships with, apart from the Product lever
rows, which are design targets until the mechanic ships. Live tuning names the knobs
and why they sit where they do, and What the checks cover says what each
automated check asserts. Numbers measured from the build are in
Measurements.
Number ranges#
Upload Labs players lose interest when numbers become meaningless (Influences). Quorum keeps every number in a real range.
| Number | Range at start | Range at the end of the first company | Hard limit |
|---|---|---|---|
| Users | 150 | 50 million | About 6 billion (online population) |
| Demand | 3 rps | 1 million rps | Users × R_user |
| Latency | 30–500 ms | 30–500 ms | |
| Cash | $300 | Trillions of game dollars | |
| Valuation | About $1 billion at the IPO | About $100 billion at 6 billion users |
Cash, revenue, and Burn are game dollars. Valuation, payout, and Legacy use real dollars, converted by the valuation scale.
Formatting: SI suffixes only (k, M, B, T). No letter suffixes such as "aa".
Constants#
| Constant | Symbol | Value | Where used |
|---|---|---|---|
| Step length | 100 ms | Simulation | |
| Calendar rate | 1 sim s = 1 calendar min | Simulation | |
| Requests per user | R_user | 0.02 rps | Demand |
| Diurnal amplitude | A | 0.45 | Demand |
| Copy price growth | 1.25× | Prices | |
| Resize price growth | 2× per size step | Vertical and horizontal | |
| Sell refund | 50% | Components | |
| Insight yield | 1 × √(sampled rps), per Component type and kind | Observability | |
| Default sample rate | 10% | Observability | |
| Default retention | 15 min; pool cap at least 100 | Observability | |
| Study duration | 20 s (Garage) to 60 min (Public) | Progression | |
| Spike speed | 2× | Team | |
| Lever steps | ×2, ×3, ×4 of the kind's share | Product levers | |
| Lever Dev Hours | 24, 80, 240 | Product levers | |
| Lever growth | 0.99, 0.98, 0.96 | Product levers | |
| Lever refund | half its Dev Hours | Product levers | |
| Growth rate | g | See User growth | |
| Churn rate | c | 0.004/s | User growth |
| Declined-round growth | 0.7 × g | Funding | |
| Abroad seed share | seed_share | 0.05 | Going global |
| Fickle share | f | 0.5 | Users and growth |
| Steady churn | s | 0.2 × c | Users and growth |
| Border mixing | m | 0.1 | Users and growth |
| Mirror time | mirror_time | 30 calendar minutes | Mirror a region |
| Staged sync wait | stage_wait | 60 calendar minutes | GitOps |
| GitOps poll | sync_poll | 3 calendar minutes (Argo CD's default) | GitOps |
| Plan refresh | refresh_time | 0.5 calendar minutes per Node | IaC tools |
| IaC tool switch | iac_switch | 1,440 calendar minutes | IaC tools |
| Valuation scale | 1.5 × 10⁻⁴ | Valuation scale | |
| Coordination penalty | k | 0.08 | Team |
| Dev Hours per day | 8 per engineer, 6.4 founder | Team | |
| Adoption time | τ | 7 calendar days | Adoption |
| Lift spread | σ | 1.0 | Measured lift |
| Upkeep ceiling | 0.4 × S / (S + 2,000), max 0.6 | Upkeep | |
| Unhappy mood | 0.35, one Mail per slump; content again at 0.7 | Burnout | |
| Page mood | −0.08 per page | Burnout | |
| Freeze mood | a calendar week of a spent budget takes all of it | Burnout | |
| Pay-gap mood | a third of a point a calendar day at a 50% gap | Burnout | |
| Time off | 3 calendar days | Burnout | |
| Block reminder | 1 calendar day after Later | Blocked | |
| Block team-size threshold | 8 engineers on one team | Blocked | |
| Market gain cap | +100% of the Era market | Sizes | |
| Link timeout | 30 s | Simulation | |
| Drawer size | max($25, 60 s of revenue) | Economy | |
| SLA credit | 10% of subscription revenue while the trailing week misses the signed target | Incidents | |
| On-call ack | 5 sim s after the page | Incidents | |
| CDC change rate | 20,000 changes/s (05) | CDC Connector | |
| Sidecar overhead | 5% of a member's CPU and Burn (05) | Service Mesh | |
| Sidecar hop | 1 ms per hop (05) | Service Mesh | |
| Mesh Insight | +20% on watched traffic (05) | Service Mesh | |
| Mesh Platform tax | 0.5 engineers per mesh | Team | |
| Rollout steps | off, 5%, 25%, 50%, 100% (05) | Feature Flags | |
| Certificate life | 90 calendar days; 45 from Series C (05) | Secrets and Certificates | |
| Certificate renewal | two thirds of the life | Secrets and Certificates | |
| L4 multiplier | 10× the capacity, 0.2 ms, 0.6× the Burn | Load Balancer | |
| Gateway burst | 200 requests on top of the limit | API Gateway | |
| ESI page gain | +20 points of page hit ratio (10) | CDN | |
| Bot management | false positives × 0.5 | WAF | |
| Schedule lead | 120 calendar minutes before the peak | Autoscaler | |
| ARM price, speed | 0.8×, and 0.95× CPU | App Server | |
| Quantization value | INT8 0.95, INT4 0.85; speed 2× and 3× | GPU Node | |
| Batch gain, TTFT | batch 8: 1.6×, +150 ms; batch 32: 2.2×, +500 ms | GPU Node | |
| Bulkhead wait | 1,000 ms per call | Links | |
| Hedge load | +10% calls on the Link | Links | |
| Serialization CPU | 0.02 reference ms per backend call | Performance | |
| Dual-write stale | 0.5% of search answers, from Series B | Keeping copies in sync | |
| Materialized view | 0.5× scan CPU, 5% stale answers | Data Warehouse | |
| Chaos experiment | every 120 s, 10 s long, 20% of the target's calls fail, 1 ◇ Failure a second | Reliability |
The rollout steps and the certificate's two lifetimes are 05's own. A mesh takes a Cluster's half an engineer of Platform Dev Hours. The pages that own each mechanic give the rate it runs at.
Four rows describe the Features lifecycle: adoption time, lift spread, the upkeep ceiling, and the market gain cap. Adoption time is exact arithmetic, stepped a Step at a time, so the 63% after a week is the continuous curve's figure rather than a closed form. The market gain cap holds the Features' market gains together at +100% of the Era's market.
Product levers#
A Product lever moves one Request kind's share of the mix. The three steps multiply the kind's share by 2, 3, and 4, and the other kinds give up the difference in proportion to their shares (Simulation). The shares below are the target at the kind's arrival Era with no other lever active.
| Kind | Base | Step 1 | Step 2 | Step 3 | App CPU per request |
|---|---|---|---|---|---|
login | 6% | 12% | 18% | 24% | 80 ms |
search | 10% | 20% | 30% | 40% | 3 ms |
upload | 7% | 14% | 21% | 28% | 120 ms |
media | 10% | 20% | 30% | 40% | 1 ms |
rt | 8% | 16% | 24% | 32% | 0.3 ms |
buy | 3% | 6% | 9% | 12% | 5 ms |
job | 2% | 4% | 6% | 8% | 400 ms |
report | 3% | 6% | 9% | 12% | 20 ms |
ai | 5% | 10% | 15% | 20% | 5 ms |
feed | 8% | 16% | 24% | 32% | 6 ms |
hook | 2% | 4% | 6% | 8% | 2 ms |
push | 2% | 4% | 6% | 8% | 0.5 ms |
The Dev Hours and the growth cost are the same for every kind: 24, 80, or 240 Dev Hours, and 1%, 2%,
or 4% off growth. Each step's growth cost adds to the one before, so three steps leave growth 7%
lower than no lever. The load is the kind's own profile, so the last column is the price of a step.
The build holds these numbers in LEVER_DH, LEVER_GROWTH, LEVER_STEPS, and LEVER_CAPS
(packages/simulation/src/catalog/levers.ts), and levers.test.ts checks them against the mix and
the revenue rule below.
The Pre-seed check. At 7,000 users and the 20:00 peak, demand is 203 rps. login is 6%, 12 rps at
80 ms, just under one core, a quarter of a 4-vCPU App Server. The default recipe is write (15%) and
login, so the Study runs at √6 against √15. Step 1 takes login to 12%, 24 rps, about 1.95 cores.
The pool earns √12, so the Study runs 1.41× faster, and the App Server spends half its box on
password hashes. Step 2 takes login to 18%. The other kinds give up the difference, so write falls
to about 13% and becomes the limit.
The Seed check. At 35,000 users and the peak, demand is 1,015 rps. upload is 7%, 71 rps at
120 ms, about 8.5 cores. Step 1 takes it to 14%, 17 cores, and the pool earns 41% more. The board
needs two more medium App Servers, or a Worker behind a Queue, because 120 ms of resize on the request
path is the wrong shape by Seed.
The revenue check. A lever's added traffic earns the value of the traffic it displaces. Without
that rule, a buy lever at Series A would take revenue per user to 3.05 times its current level,
because a checkout is worth $25 and the traffic it displaces is worth about $1. The rule keeps the
lever a research investment, not a growth exploit.
The levers are design targets. The catalog does not carry them until the mechanic ships.
Prices#
The 1.25 growth on copies is a soft push toward bigger instances and toward better design over more copies. It is stylized, because real clouds charge the same for the hundredth VM as the first. The justification is operational overhead, and the card says so. Selling refunds half of what the last copy cost, at the copy markup.
Cost index#
Request values stay fixed. Prices rise with the Era. Every price in this document is a Garage price, and the Era's cost index multiplies it: placement, Burn, egress, and third-party fees. A separate salary index multiplies engineer salary. Without them, a vCPU costs about 0.1% of the value of the requests it serves, and Burn never matters.
| Era | Cost index | Salary index | vCPU ($/s) | Engineer salary ($/s) |
|---|---|---|---|---|
| Garage | 1 | 1 | 0.05 | 0.40 |
| Pre-seed | 4 | 4 | 0.20 | 1.60 |
| Seed | 8 | 8 | 0.40 | 3.20 |
| Series A | 12 | 12 | 0.60 | 4.80 |
| Series B | 16 | 16 | 0.80 | 6.40 |
| Series C | 20 | 20 | 1.00 | 8.00 |
| Pre-IPO | 24 | 24 | 1.20 | 9.60 |
| Public | 24 | 24 | 1.20 | 9.60 |
Garage and Pre-seed sit at the floor because there the smallest box, not the traffic, sets the cost. From Seed the index climbs by 4 points an Era, so infrastructure and payroll grow with the company while request values stay put. Salary follows the index, and the language factor multiplies on top of it (Runtimes). The factors are:
PHP 0.85.
Node.js and C# 1.0.
Python and Java 1.05.
Ruby 1.1.
Go 1.15.
Elixir 1.2.
Rust and Zig 1.25.
Haskell 1.4.
The catalog's cost and salary indexes are the build's prices and the normative economy baseline: margin and Burn are measured at these indexes. Live tuning covers pacing knobs (growth and incidents), not a separate price level.
A Balanced design should land at a margin of 25% to 45%, which puts the Rule of 40 checklist item
within reach but not free. pacing.test.ts asserts positive build margins at early Era milestones
and records later margins; Measurements holds the last measured snapshot.
Valuation scale#
Game revenue is stylized: 50 million users at 0.02 rps send 1 million rps, and the average request is worth about $1 to $3. A year of that revenue is about $500 billion. A real company of that size reports an ARR near $77 million. The valuation scale, 1.5 × 10⁻⁴, converts a year of game revenue into that real ARR. At the IPO, a Rule of 40 multiple of 13 gives a Valuation of about $1 billion. At 6 billion users the Valuation is about $100 billion.
Vertical and horizontal#
A size step doubles vCPU, RAM, and Burn. Price is linear in resources, as in real clouds, so price per vCPU does not decide between one big box and many small ones. These tradeoffs do:
| One big box | Many small boxes |
|---|---|
| No load balancer, no network hop | Redundancy: one failure loses a fraction |
| One runtime base memory instead of many | Fine-grained scaling: add 10%, not 100% |
| Runtimes that cannot use more cores waste the size (Node.js on one loop, a pool at one worker) | Needs a load balancer and more connections to the database |
| Resize means a restart | Rolling changes |
Hard cap at metal (96 vCPU) | Each copy costs 25% more to place |
Flat Components have size steps of their own, and each step doubles both capacity and Burn:
Payments 6.
Analytics 8.
Load Balancer 6.
Connection Pooler 4.
Cache 8.
Search Engine 8.
Queue 6.
WAF 6.
Payment Provider 8.
GPU Node 8.
LLM API 8.
Wide-column Store 6.
Distributed SQL 6.
Document Store 8.
Event Stream 6.
Realtime Hub 8.
Vector Index 6.
User growth#
| Era | g (per sim second) | Time to the milestone at Apdex 1.0 with no capacity limit |
|---|---|---|
| Garage | 0.0040 | 12 minutes, from 150 to 1,000 |
| Pre-seed | 0.0022 | 21 minutes, from 1,000 to 5,000 |
| Seed | 0.0016 | 28 minutes, from 5,000 to 25,000 |
| Series A | 0.0009 | 56 minutes, from 25,000 to 150,000 |
| Series B | 0.0007 | 1 hour 12 minutes, from 150,000 to 1 million |
| Series C | 0.0005 | 1 hour 56 minutes, from 1 million to 10 million |
| Pre-IPO | 0.0003 | 2 hours 30 minutes, from 10 million to 50 million |
| Public | 0.0002 |
The times solve the logistic equation from the Era's start to its milestone with the market sizes in
Progression: t = ln(((M − U₀) / U₀) × (U₁ / (M − U₁))) / g. The sum is
about 7 hours 36 minutes.
From Series C the formula runs per region (Simulation). With
seed_share at 0.05, a Company that reaches Series C with 1,000,000 users starts Europe at 37,500,
Asia-Pacific at 25,000, and South America at 12,500. Far demand is then about 7% of the total, not
60%, so a single-region Design meets the round trip as a warning, not as a collapse. North America's
market alone is 5.6 million, so the 10 million Milestone needs users abroad. The table above assumes
one region and the Era's full market.
Churn is steep on purpose, and much steeper than in real life. Brutlag (2009) found that 400 ms of extra latency cost Google 0.59% of searches over six weeks; the game compresses weeks into minutes. Fickle users carry the steepness: at the Series C target of 0.92, an Apdex of 0.91 loses them at about 3% per calendar hour. Steady users leave at a fifth of that. Three calendar days at 0.909 take a region of 1,000,000 users, half of them steady, to about 360,000, not 93,000 as with one rate. The Churn breakdown shows the rate.
Word of mouth crosses borders at m = 0.1. With 1,000,000 users at home, a region abroad grows as
if it had 100,000 users of its own on top of its seed, so it fills fast once its users are served
well, and it recovers after it lost its users.
Brutlag also found that searches stayed low for a while after the delay was removed. The game does not model that lag: users respond to the last calendar hour only, so a fix shows its effect within the hour. A lag would hide the feedback the Churn breakdown exists to give.
These are lower bounds. Capacity, Cash, and research make a real player slower, while Features raise
g and the market, which makes growth faster still.
Growth alone sets the length of the first two Eras. At g × 1 the Garage takes 12 sim minutes to go
from 150 to 1,000 users and Pre-seed 21 more to 5,000, so Seed arrives at about 33 sim minutes
whatever the Design does. At the Company pace, where g is doubled, the same growth takes half as
long.
Pacing model#
The pacing model is a set of scripted players that run against the real simulation in tests, so a balance change shows up as a test failure rather than in a playtest report. Every bot leaves the Team's autopilot on, and every bot but Greedy hires while payroll, the new hire included, stays under 25% of revenue, up to 4 engineers.
| Bot | Strategy | Design limit | Check |
|---|---|---|---|
| Balanced | Relieves the bottleneck Node, researches by a fixed priority list, builds each Era's content | Inside the targets | Seeds 1–5: Seed reached on every seed at 26.8–35.7 sim minutes, Pre-seed within 20 min, positive Garage and Pre-seed margins |
| Greedy | Bigger boxes and the cheapest research; never hires | Not beat a target by more than 40% | Seeds 1–3: Seed no faster than 27 minutes |
| Stubborn | Never changes the starting Stack | Reach IPO within 1.6× the target time | Seeds 1–3: Seed within 1.6× Balanced on the same seed |
| Polyglot | Migrates to every language it researches | Not beat Balanced by more than 30% | Seeds 1–3: Seed no faster than 0.7× Balanced |
| Decliner | Plays Balanced and declines every funding round | Legacy per hour not beat Balanced by more than 15% | Seeds 1–3: reaches Seed with Equity at 100% |
| Idle | Plays Balanced, but logs in every 2 hours, spends everything, and leaves | Reach Pre-seed within 24 hours of game time | Not asserted; run it by hand when tuning |
| Margin | Plays like Balanced and records margin at each Era milestone | Margin in 25% to 45% from Seed on | pacing.test.ts records the margin at Seed and Series A entry |
A balance change passes when the Balanced bot meets its limits on seeds 1–5 (pacing.test.ts, under
FULL_TESTS=1). The other bots run by hand through runBot when a change touches their limit.
Dominance#
Pillar 2 says no option strictly dominates another. Within each language, every runtime must beat each of its siblings by at least 10% on one reference score:
Throughput on the real Ledger of a Pre-seed Design.
RAM per process.
Realtime connections per GB.
Startup.
Cold speed.
Stall-free CPU work.
GC pause.
Leak-proof processes.
A self-sized pool.
One of the six axes of its profile.
Each language's frameworks follow the same rule: no framework is at least as good as a sibling on every score (CPU, memory, velocity, coordination, debt, background hours, per-kind CPU and value, startup, ORM, cacheability, native build, and the six axes) and better on one.
Across languages, BEAM holds the most realtime connections per GB, beating Go and Kestrel. The option sets are the 28 runtimes, each language's frameworks, the instance families (Burstable, General, Compute, Memory), and the PHP-FPM pool modes. Axum and Actix are within about 5% of each other on CPU and velocity, and ARM runs at 0.8× the price and 0.95× the CPU, so a CPU-millisecond on ARM costs 0.84× General's. The fix for a dominated option is to change the option, not to tweak a number.
Runtime balance targets#
These comparisons hold on the real Ledger of a Pre-seed Design:
| Check | Target |
|---|---|
| Java cold against warm throughput | 30% at start, 100% after 30 s |
| Rust against Go, server cost for the same load | 25% to 40% lower |
| Rust against Go, Dev Hours for the same feature set | 50% to 70% higher |
Elixir against Node.js, rt connections per GB | 3× to 5× |
| Rails against Go, Dev Hours for the same feature set | 35% to 50% lower |
Under a PHP-FPM Design with OPcache, Node.js cluster mode answers read at 1.5× to 2.5× the throughput per
dollar, and 3× to 6× with a database at 100 ms. A single Node.js process with 6% login adds 40 to
120 ms to p99.
Prestige curve#
| Company | Expected payout | Legacy | Cumulative | Shop progress (1,766 ★) |
|---|---|---|---|---|
| 1 | $500 million | 22 | 22 | 1% |
| 2 | $1.5 billion | 38 | 60 | 3% |
| 3 | $5 billion | 70 | 130 | 7% |
| 5 | $20 billion | 141 | 371 | 21% |
| 8 | $50 billion | 223 | 967 | 55% |
| 9 | $80 billion | 282 | 1,249 | 71% |
| 12 | $200 billion | 447 | 2,442 | the whole shop, and a third again |
The twelve perks of the Legacy shop cost 1,766 ★ in all. The cumulative column follows payouts of $500 million, $1.5, $5, $10, $20, $30, $40, $50, $80, $120, $160, and $200 billion for companies 1 to 12, so the shop is complete around the eleventh company.
Payout is Equity × Valuation × the Exit's multiplier, so the rounds set it (Economy):
10% at 1,000 users.
19% at 5,000 and 25,000.
13% at 150,000.
12% at 1,000,000 and 10,000,000.
15% sold in the IPO offering.
Live tuning#
The pacing knobs live in catalog/tuning.ts, and the cost and salary indexes in each Era
(EraDef.costIndex and EraDef.salaryIndex). Two tunings read them:
A Company plays at
LIVE_TUNING: growth × 2, an incident every 400 sim seconds, and the first 90 seconds after the Pre-seed raise.A Challenge and a Sandbox replay at
CHALLENGE_TUNING: growth × 1, an incident every 720 seconds, and the first after 600. The pacing bots use it too, so a run shows a whole curve inside a test.
Both share the calendar pace, so a calendar day lasts 60 sim seconds. The tuning parameter of
step, growthOf, directIncidents, raise, and decline selects one.
| Knob | Challenge pace | Company pace | Why they differ | Constant |
|---|---|---|---|---|
| Growth pace | g × 1 | g × 2 | A session of 15 to 30 minutes needs the faster rate; a replay keeps the slower one so a whole curve fits a test | CHALLENGE_TUNING, LIVE_TUNING (PLAYTEST_PACE) |
| Incident gap | 720 sim s mean (12 minutes) | 400 sim s mean | A replay spreads incidents across the curve; a session has to meet several | INCIDENT_GAP |
| First incident | 600 sim s after the Pre-seed raise | 90 sim s after the Pre-seed raise | A session meets an incident early; a replay does not need to | FIRST_INCIDENT_AFTER |
| Calendar pace | 60 sim s a day | 60 sim s a day | One value for both: a hire and a deploy have to fit inside a session | CALENDAR_PACE |
The cost index, the salary index, and the speeds are one value each, set per Era or per perk rather than per tuning:
| Knob | Value | Why | Constant |
|---|---|---|---|
| Cost index | 1 / 4 / 8 / 12 / 16 / 20 / 24 / 24 | Rises with the Era so Burn stays a real share of revenue at every size of company | EraDef.costIndex |
| Salary index | follows the cost index: 1 / 4 / 8 / 12 / 16 / 20 / 24 / 24 | Payroll has to stay a real share of Burn at the prices the player pays | EraDef.salaryIndex |
| Company speeds | 0.5×, 1×, 3×, 10×; 20× and 40× with Time dilation | A slower speed for watching a Design settle, faster ones for the late Eras | SPEEDS, DILATION_SPEEDS |
| Request mix | Request mix by Era | login and upload cost 80 and 120 ms of CPU, so an Era that keeps under 5% of either starves its Insight pool and every Study that draws on it. The Product lever is the way out | EraDef.mix |
What the checks cover#
pacing.test.tsplays the Balanced bot against the real Simulation on seeds 1–5; it runs underFULL_TESTS=1, which CI does not set.breadth.test.tsasserts determinism, finite numbers and save round trips across the whole catalog; it also runs underFULL_TESTS=1.research.test.tsasserts each Era's mix sums to one, and that the Era introducingloginanduploadkeeps a real share of each, so their Insight pools do not dry up. When Product levers ship, it also asserts every pool a default recipe names has one, and every step keeps the mix at one.The bridge and the shutdown fire at the numbers in Economy; no bot plays a Company into a shortfall.