Docs

How the roost works

Voltroost is a browser idle game. You build a wooden barn full of GPU rigs, fill compute orders from fictional AI labs, and keep the floors cool. Nothing to install, no wallet needed to play.

Playing

Your roost starts with one floor and one rig, and the first order is already on the board: Mothlab needs 20 GPU-h within 60 s. Tap the rig to overclock it and the order fills in well under 30 seconds.

  • Orders. The board holds three orders. Each names a fictional lab, the GPU-hours it needs, a deadline and the credits it pays. Your rigs fill one order at a time: the one you tapped, otherwise the one closest to its deadline. A missed deadline just removes the order; no penalty. Bigger orders need more floors and pay more per GPU-h.
  • Rigs. Up to 6 per floor. Higher floors hold newer rigs: 1, 2.6, 7 and 19 GPU-h per second per rig on floors 1 to 4.
  • Overclock. Tap a rig (or press Space) to run it at 3× for 6 seconds. It heats the floor.
  • Coolers. Up to 3 duct fans per floor. Each one pulls heat out faster.
  • Floors. Build floors 2, 3 and 4 with credits. The barn grows upward and a worker climbs the ladder to the new floor.

Heat & throttle

Every floor has a heat gauge from 0 to 100°. Rigs warm their floor a little, overclocked rigs a lot, and coolers pull it back down.

Per secondHeat
each rig+0.55°
each overclocked rig+4°
the floor itself (no cooler)−2°
each cooler−2.2°
At 90° a floor throttles: its rigs glow red, smoke, and run at 40% until the floor is back under 60°. Overclocking is off while a floor is throttled. A full floor of 6 rigs warms up even without overclock, so it needs at least one cooler.

While you slept

Close the tab and come back later: the game counts the time you were away, up to 8 hours. Rigs run at normal speed (no overclock) on standing contracts at 0.8 credits per GPU-h. Floors without enough cooling spend part of the night throttled, and the summary card says which floor ran hot. From the card you can share the night on X.

The curve

The numbers below come from web/scripts/sim.mjs, which plays the real game model with a simple bot: it taps one rig every 1.5 seconds (only on floors under 50°), buys the rig with the best output per credit, adds a cooler when a floor runs warm, and saves up once the next floor is less than 75 seconds of income away. Median of 60 runs.

MilestoneActive playNo tapping
First order filled8 s20 s
Floor 2 (680 cr)2 min 50 s3 min 47 s
Floor 3 (8,400 cr)11 min 38 s15 min 38 s
Floor 4 (92,000 cr)37 min 45 s50 min 53 s

Overnight instead: a roost with a full first floor and 4 rigs on floor 2 earns about 264,000 credits in 8 hours away, enough for floor 4.

Rig prices grow 1.32× per rig on the same floor (first rigs: 14, 200, 2,000 and 16,000 cr). Coolers grow 2.4× per level (first: 28, 400, 4,000 and 32,000 cr).

On-chain vs local

Local (your browser)

Credits, rigs, coolers, floors 1–4, heat and orders. The game saves in localStorage every few seconds. Use the save button under the barn to export a code and import it elsewhere. There is no account and no game server, which also means credits can be edited by anyone who wants to: that is why they never appear on any board.

On-chain (Robinhood Chain, chain id 4663)

The VoltroostRegistry contract holds three things: claimed roost names, deed floors, and the total $VOLTS burned.

  • claimRoost(name): free (gas only), one roost per wallet, unique name of 3–16 characters from a–z, 0–9 and dashes, not starting or ending with a dash.
  • buildFloor(): builds a deed floor (floor 5 and up, at most 8) by burning $VOLTS to 0x000000000000000000000000000000000000dEaD. Price = base price × (deed floors you have + 1). Each deed floor adds +25% to every rig in your game while the wallet that owns the roost is connected.
  • setToken(address): a one-time call by the deployer right after launch that points the registry at $VOLTS (it must report the symbol VOLTS). Until then deed floors cannot be built. Claiming works before that.

Registry: Registry deploys before launch (address appears here)

The Tallest roosts board reads the registry directly: roosts with deed floors (from the contract's FloorBuilt events), ranked by deed floors, then by claim time.

Limits

  • The AI labs are fictional. No real GPUs are rented, nothing is computed for anyone, and the game pays nothing out.
  • The registry has no admin, no pause and holds no ETH, but it is not audited; it had an internal review only.
  • Burned $VOLTS cannot be recovered.
  • Offline progress is capped at 8 hours.
  • Clearing your browser data deletes your local roost unless you kept a save code. Your on-chain roost name and deed floors stay.

Questions: @playvoltroost on X.