WHITEPAPER · v0.3 PLAY ↗
// risk-to-earn · pixel ranch · $BULL

A ranch that pays you to hold the line.

BULL.GAME is a pixel-art risk-to-earn ranch. Your cows mint $BULL every second. Stake the herd for 3× yield into a raidable vault, survive the dusk stampede, and claim the winnings — or lose the vault to the bulls. The bulls are driven by an LLM raid-brain called the Horned Oracle. No team allocation. No presale. Just the loop.

01The loop

Each day is one economic cycle. Cows produce. Tension builds at dusk. Bulls raid. Winners get paid. Then the sun comes up and the herd grows.

DAY
45s
cows wander + mint $BULL
DUSK
5s
warning · vault seals
RAID
8s
bulls stampede · oracle commands
PAYOUT
survivors claim · streak bonus

02The $BULL economy

Every cow passively mints $BULL at a base rate of 0.14 $BULL/sec. Buy more cows, upgrade the barn, stack hay bales and silos to multiply output. The currency you earn is the currency you stake — and the currency the bulls try to steal.

Produce

Cows + calves + prize cows mint $BULL around the clock. Prize cows yield 2× permanently; hay bales burst output ×1.5 for 30s.

Stake

Stake the herd for 3× yield — but the 3× goes to the vault, not your spendable balance. Higher reward, higher exposure.

Risk

The vault is raidable. Every dusk, bulls scale with vault size + your risk factor. Survive to claim; fail and you salvage only 30%.

Claim

Safe-claim pulls the vault anytime (except mid-raid) at a 10% fee. Or hold for the stampede and claim 60% × streak bonus.

03Staking & risk

04The Horned Oracle

The bulls don't raid on a script. Each dusk, a lightweight LLM (qwen-2.5-7b-instruct via OpenRouter) is prompted with the live ranch state — herd size, vault size, rancher count, risk — and returns a raid doctrine that drives bull AI for that stampede. Cheap (~$0.00005/call, sub-second) and deterministic enough to feel fair, unpredictable enough to keep you honest.

DoctrineWhat the bulls doTarget bias
vault_crackerIgnore the herd, hammer the vault walls.vault
cow_hunterChase down prize + weak cows first.prize_cows / weak_cows
panic_stampedeSpread the herd, trample everything.weak_cows
feintFake the vault, swing at the cows.ranchers / prize_cows

Each doctrine also carries an aggression value (0–1) that scales bull speed, ram force, and trample chance for that raid. The Oracle is rate-limited per-IP (6/min) and globally (60/min) so it can't be spammed.

05Rancher defense

Hire ranchers to hunt bulls within 90px. Each rancher closes in and lands 3 hits (0.6s cooldown) to down a bull — gold puffs on every connect. More ranchers = higher defense (capped at 90%), which lowers raid severity and trample odds. The rancher is your only answer when the Oracle sends the herd at your vault.

06Shop & upgrades

ItemCostEffect
Cow10 + herd×4Baseline 0.14 $BULL/s
Calf5 + herd×2Grows into a cow after 20s
Prize cow120 + prize×602× yield, permanent
Rancher200 × 1.55^ranchers+15% defense (cap 90%)
Hay bale40×1.5 yield for 30s (stacks w/ stake)
Ranch upgrade50 × 1.75^(barn-1)+4 herd cap, −10% risk
Silo300 × 1.8^silosAuto-feeds herd 30s at dawn

07Rebirth (prestige)

At 25,000 $BULL earned you can rebirth: herd and upgrades reset, but you gain a permanent +25% yield multiplier that stacks forever. Rebirth is the long game — each cycle compounds the next.

08Tokenomics

09Roadmap

PhaseShip
v0.3 — liveRanch loop, sprites, Horned Oracle raid-brain, staking/risk, rebirth
NextPersistent leaderboard, save/load state (localStorage), bull variants
On-chainSolana SPL $BULL, real vault contract, on-chain raid outcomes
ScaleMulti-ranch seasons, sell-cows for scaled $BULL, mobile tune
BULL.GAME · whitepaper v0.3 · pixel-art risk-to-earn play · x