# BRAINROT Lab — mechanics ruleset (v3.2)

> Generated from the Lab worker’s own code constants at request time — always current.
> Generated 2026-10-24T04:01:51.300Z. JSON twin: https://lab-api.brainrot.works/rules.json. Human docs: https://lab.brainrot.works/how-it-works.

## Currencies
- BRAINPOINTS (BP): soulbound; earned by burning, spent on lab actions.
- STAMPS: soulbound unlock keys — weapon, companion, costume, material, variant, rare, epic. burning a token whose HISTORY carries the matching trait (see burn.stamps).

## Burn value (BP)
Formula: `base(standing) + evolutions*evolutionBp - min(bankGrafts, evolutions)*(evolutionBp - bankGraftBp)`
Standing base BP:
- DEATH SENTENCE: 200
- SLOP: 125
- COOKED: 115
- NOTED: 100
- MEMORABLE: 110
- EXEMPLARY: 120
- IMMORTAL: 150
- no standing / NOTED: 100
- evolutionBp: 50 (bank-graft evolutions redeem 25)
- Zeitgeist (ids 9901–10000): flat 4000, ignores everything else.

## Burn stamps
- one stamp per DISTINCT stamp-yielding trait the token has EVER carried, across all versions (divergent time-travel branches included)
- Dedupe: category + lowercased value — the same trait worn in many versions counts once
- Tier stamps: rare/epic derive from the CURRENT Rarity Tier only (high-water, max one per burn); zeitgeists also yield epic
- Endpoint: GET https://lab-api.brainrot.works/burn/stamps/{tokenId} -> { stamps: string[] }

## Jackpot
- pool starts 100 BP, +25 per burn, +100 per day; every burn rolls; win probability = `min(0.05, 0.00667 + 0.0000045 * max(pool - 100, 0))`; winner takes the pool, resets.

## Trait Bank
- Reserve at burn: 5 BP each for the first 9 traits, then 15 BP per trait, unlimited count, fee capped at the burn yield (traits past the cap are free). paid ONLY out of the burn’s own BP yield, capped at the full yield — the burn can go to 0 BP, never below, and every trait past that point is free; the wallet is never charged
- Scope: any bankable trait from the token’s ENTIRE version history; a trait the token APPLIED more than once (removed and re-added, or stacked) is claimable that many times — one copy per genuine application, time-travel re-wears excluded; extra copies of a CAPPED trait need live supply headroom
- Stamp forfeiture: every banked stamp-yielding trait cancels the stamp it would have paid — trait or stamp, never both
- Apply: 25 BP/trait + $0.5 fee, max 5 per apply. each grafted trait adds one Evolution redeeming 25 BP at burn (not 50) — bank-cycling is BP-neutral
- Legendary and Zeitgeist tokens cannot be banked from or applied onto.
- a vaulted capped trait keeps its edition slot; it moves to the target token on apply.

## Actions & prices
- expression: 50 BP + $1 fee (6 images/roll)
- remove: 0 BP + $0.5 fee (3 images/roll)
- rebuild: 0 BP + $0.5 fee (3 images/roll)
- rebuildtrait: 0 BP + $0.5 fee (3 images/roll)
- remaster: 0 BP + $1 fee (3 images/roll)
- cute: 0 BP + $0.5 fee (3 images/roll)
- rotten: 0 BP + $0.5 fee (3 images/roll)
- advremaster: 0 BP + $2 fee (2 images/roll)
- collab: 50 BP + $0.5 fee (3 images/roll)
- hair: 50 BP + $1 fee (6 images/roll)
- facialhair: 50 BP + $1 fee (6 images/roll)
- fashion: 50 BP + $1 fee (6 images/roll)
- accessory: 50 BP + $1 fee (6 images/roll)
- weapon: 50 BP + weapon stamp + $1 fee (6 images/roll)
- companion: 50 BP + companion stamp + $1 fee (6 images/roll)
- costume: 50 BP + costume stamp + $1 fee (6 images/roll)
- material: 100 BP + material stamp + $1 fee (6 images/roll)
- variant: 100 BP + variant stamp + $1 fee (5 images/roll)
- nuke: tiered (see nukeTiers) + $1 fee (6 images/roll)
- traitroll: tiered (see nukeTiers) + $1 fee (6 images/roll)
- bodyroll: tiered (see nukeTiers) + $1 fee (6 images/roll)
- custom: 1000 BP + $1.5 fee (10 images/roll)
- zeitgeist: 100 BP + $0 fee (0 images/roll)
- legendary: 5000 BP + $0 fee (0 images/roll)
- combo: 0 BP + $1 fee (6 images/roll)

fees are USD, paid in ETH or prepaid credit; the standard roll fee is $1. BP and stamps charge only on COMMIT — walking away costs the fee alone.

## Nuke / Body Roll tiers
- BP by chosen tier: common 50 / uncommon 100 / rare 150 / epic 200
- Odds: 92% in the chosen tier, 8% exactly one tier higher (epic tops out)
- Stamp gate: the token’s own tier and below are stamp-free; choosing rare/epic ABOVE the token’s tier spends the matching stamp ON TOP of the BP (never instead of it)
- a committed body can only RAISE Rarity Tier (high-water; never downgrades)
- Mythic 1/1 drop odds by tier: common 1/500, uncommon 1/500, rare 1/250, epic 1/100 (nuke only)
- a rebody wipes material/variant layers from the CURRENT look; they remain in history (stamps at burn / bankable / time-travel-wearable)

## Edition caps
- Model: supply = DISTINCT tokens that have EVER carried the trait; permanent — burning does not free a slot; a token may always re-wear its own history
- Schedule (category-group x rarity):
  - body: Common 50 / Uncommon 30 / Rare 20 / Epic 15 / Mythic 5
  - anatomy: Common 20 / Uncommon 15 / Rare 11 / Epic 9 / Mythic 7
  - expression: Common 90 / Uncommon 60 / Rare 40 / Epic 40 / Mythic 40
  - fashion: Common 60 / Uncommon 38 / Rare 22 / Epic 14 / Mythic 8
  - companion: Common 55 / Uncommon 40 / Rare 28 / Epic 14 / Mythic 12
  - material: Common 55 / Uncommon 55 / Rare 40 / Epic 28 / Mythic 28
  - variant: Common 20 / Uncommon 20 / Rare 20 / Epic 20 / Mythic 20
- 68 per-trait named overrides. Live supply: GET https://lab-api.brainrot.works/catalog/library

## Time travel
- every version stored forever; wearing an old look commits a NEW version; Evolutions restore to the worn version’s count Free.

## Legendaries
- once all 25 are claimed, owning a Legendary is the only way a new one is minted
- art is permanent — commissions join the lineage, never overwrite
- no BP from burning; 5000 BP only via transfer back to Nuclear Samurai
- cannot be modified by normal lab actions, banked from, or applied onto
- commission: 5000 BP; supply 25 (3 reserved).

## Marketplace card
- animation_url: https://lab-api.brainrot.works/embed/{tokenId} — interactive card (front: art; back: live burn value, stamps, time travel, trait bag) — server-rendered per view, always current

## Valuation guide (for builders)
1. GET https://api.brnrt.dev/metadata/{id} — read attributes: Standing, Evolutions, Bank Grafts, Rarity Tier, Archetype
2. if Archetype == Legendary: burn value = 0 (transfer-back 5000); if id in 9901..10000 (Zeitgeist): 4000
3. else BP = standingBase (table above; missing/NOTED = 100) + Evolutions*50 - min(BankGrafts, Evolutions)*25
4. stamps: GET https://lab-api.brainrot.works/burn/stamps/{id}
5. claimable traits (the trait bag) mirror the stamps’ history rule — shown on the token’s card

## Public endpoints
- metadata: https://api.brnrt.dev/metadata/{id} (versioned: /metadata/{id}/{v})
- burnStamps: https://lab-api.brainrot.works/burn/stamps/{id}
- catalog: https://lab-api.brainrot.works/catalog/library
- embedCard: https://lab-api.brainrot.works/embed/{id}
- rules: https://lab-api.brainrot.works/rules (markdown) | /rules.json
- cpi: https://cpi.brainrot.works (keyed; docs at https://developers.brainrot.works)