Grimroll
Serial GR-MNL-0031 · Rev 2.6Page 01 / 10
Machine Manual

The Undercade Manual

Somewhere below the last working arcade in town, a card-dispensing machine keeps turning long after closing time.

This manual explains the simulation, rarity table, card structure, and future Solana integration points.

Simulation BuildNo Mint Contract Deployed
Pixel art of Voltwright Adept

Voltwright Adept

#11
Epic

Sample Output

Simulation only — no transaction will be requested

How It Works

Game Loop

Four steps run today. Two more are future rails.
  1. 01Live

    Connect

    Plug in a Solana wallet. No charge, no transaction.

    Rail: Input

  2. 02Live

    Spin

    Pull the lever on the rarity wheel.

    Rail: Wheel

  3. 03Live

    Reveal

    The machine lifts a card into the light.

    Rail: Output

  4. 04Live

    Collect

    Cards enter your local session collection.

    Rail: Archive

  5. 05Future

    Trade

    Future marketplace rail.

    Rail: Market

  6. 06Future

    Compete

    Future ranked seasons and quests.

    Rail: Arena

The Math

Rarity Odds

Every simulated spin reads from one tunable rarity table.

Rarity Terminal

Table v1 · Feed: Simulated

Rarity tiers with their spin probability, visual signal, and approximate frequency
TierProbabilityVisual SignalApprox. Frequency
Common60%Pale Steel60 in 100 spins
Rare25%Electric Blue25 in 100 spins
Epic12%Arc Purple12 in 100 spins
Legendary3%Machine Gold3 in 100 spins

100-Spin Sample Strip

60 steel · 25 blue · 12 purple · 3 gold

A strip of 100 squares representing 100 simulated spins: 60 common, 25 rare, 12 epic, 3 legendary.

  • Odds are configurable in code — one constant, not per-spin logic.
  • This page describes simulated spins only.
  • Real on-chain mint odds are not implemented here.
  • Small samples may not match exact percentages — outcomes are random, never guaranteed.

Card Anatomy

What's On A Card

Every region of a Grimroll card, numbered like a parts diagram.
Pixel art of The House Edge

The House Edge

#14
Legendary

The part of the machine that always wins. It let you have this one.

Fig. 02 — The House Edge · First Roll · No. 14
  1. 1

    Nameplate

    The card's name, printed beneath the art window.

  2. 2

    Tier Badge

    Rarity as text — never color alone.

  3. 3

    Card Number

    Stable position in the 15-card First Roll set.

  4. 4

    Art Window

    Pixel art portrait, unique per card in the set.

  5. 5

    Description

    One line of Undercade lore.

  6. 6

    Faction & PowerDetail Panel

    Flavor stats for the card's machine faction.

  7. 7

    AbilityDetail Panel

    A named trait, listed in the card detail panel.

  8. 8

    Edition MarkerDetail Panel

    Which set the card belongs to — currently First Roll.

  9. 9

    Rarity Frame

    Border and glow scale with tier, from steel to gold.

Tokenomics

Keeping This Modest

Conceptual only. Nothing here is a financial claim or live economy.

Current Demo

Implemented Now
  • No live token
  • No mint contract
  • No real supply enforcement
  • No real market fees
  • No rewards
  • No revenue claims

The machine takes nothing and pays nothing. Every spin is free simulation.

Future Concepts

Not A Claim
  • Fixed card set per season
  • Rarity tiers carried on-chain
  • Seasonal sets
  • Marketplace fee concept
  • Collector rewards concept
  • Game utility concepts

Sketches on the schematic, not promises. None of this is built or guaranteed.

No live token or economy exists in this demo.

Roadmap

Four Phases

Machine modules unlock in order. Only the first is powered today.
  1. Live
    Phase 01Live

    Machine Activation

    The Undercade machine boots up.

    • Website
    • Wallet connect
    • Spin simulation
    • Base card set
  2. Phase 02In Progress

    On-Chain Set

    Cards become real, verifiable, and yours.

    • Metadata pipeline
    • Mint program
    • Verifiable ownership
    • Collection reads
  3. Phase 03Planned

    Trading Terminal

    The market goes live.

    • Marketplace
    • Listings
    • Escrow
    • Creator royalties
  4. Phase 04Planned

    Arena Protocol

    Collectors compete for the top of the machine.

    • Collector quests
    • Ranked seasons
    • Card utility
    • Competitive game modes

Transparency

Technical Scope

What's actually running today, and what is not.

Implemented

  • Static frontend (Next.js)LIVE
  • Wallet connect (connect-only)LIVE
  • 15-card set, procedural pixel artMOCK
  • Weighted spin simulationLIVE
  • Local session collectionLIVE
  • Marketplace listingsMOCK
  • Leaderboard rankingsMOCK
  • Rarity tableLIVE
  • Responsive pagesLIVE

Not Implemented

  • Mint transactionNOT CONNECTED
  • On-chain metadataNOT CONNECTED
  • Marketplace escrowNOT CONNECTED
  • Token transfersNOT CONNECTED
  • Backend or databaseNOT CONNECTED
  • Real ranking systemNOT CONNECTED
  • Chain-indexed wallet collectionNOT CONNECTED
  • Contract deploymentNOT CONNECTED

Future Integration Points

  • lib/spin.tsFUTURE

    → replace mock result with on-chain mint result

  • data/cards.tsFUTURE

    → swap mock cards for real metadata

  • /collectionFUTURE

    → add wallet ownership reads

  • /marketplaceFUTURE

    → connect listings and escrow

  • /leaderboardFUTURE

    → add indexed ranking data

  • /aboutFUTURE

    → update scope after contract deployment

Manual Complete
Pixel art of Jackpot Sovereign

Simulated output only

Now Pull The Lever.

You have read the warning label. The machine is still waiting.

Enter The MachineView Collection

Spin to reveal — mint from Add To Collection