# 🚀 Naddie Jump — Monad Edition

A vertical endless jumper inspired by Doodle Jump, themed around the **Monad Blockchain** ecosystem.

Play as **Naddie**, the purple Monad mascot, and jump your way up through blockchain blocks while avoiding bugs, high gas fees, and collecting power-ups like the Propeller Hat and Fast Transaction Rocket!

![Naddie Sprite Sheet](public/assets/sprites/naddie-spritesheet.png)

---

## 🎮 Features

- **Classic Doodle Jump gameplay** with blockchain twist
- **4 platform types**: Stable, Pending (moving), Reverted (breaking), Genesis (gold 2× multiplier)
- **3 power-ups**: Spring (super jump), Propeller Hat, Rocket Ride
- **2 enemy types**: Software Bugs and High Gas Fee traps
- **Combo system**: Chain jumps for score multipliers up to ×3
- **Milestones**: Visual celebration every 100 blocks ("New Epoch!")
- **Adaptive difficulty**: Gaps widen and enemies appear more often as you climb
- **Touch & keyboard controls**: Arrow keys, WASD, or tap left/right sides
- **Web3-ready architecture**: `BlockchainManager` stub ready for Monad integration

---

## 🛠 Tech Stack

| Layer | Tech |
|-------|------|
| Engine | Phaser 3.70 |
| Build | Vite |
| Language | JavaScript (ES6+) |
| Future Blockchain | Monad EVM + Viem/Ethers |

---

## 🚀 Quick Start

```bash
npm install
npm run dev
```

Open `http://localhost:5173` in your browser.

---

## 📁 Project Structure

```
src/
  scenes/
    BootScene.js      # Asset loading & atlas generation
    MenuScene.js      # Main menu & leaderboard mock
    GameScene.js      # Core gameplay loop
    GameOverScene.js  # Results & restart
  entities/
    Player.js         # Naddie character
    Platform.js       # Stable / Moving / Breaking / Genesis
    Enemy.js          # Bugs & Gas Fee traps
    Spring.js         # Super jump pad
    PropellerHat.js   # Fly power-up
    Rocket.js         # Rocket ride power-up
  managers/
    PlatformManager.js  # Procedural generation
    ScoreManager.js     # Gas Score & Block Height
    BlockchainManager.js # Web3 abstraction stub
  config/
    game.config.js    # Balance constants
  utils/
    sprite-atlas.js   # Sprite sheet coordinates
contracts/
  NaddieJump.sol     # Future on-chain leaderboard
```

---

## 🔗 Blockchain Roadmap

### Phase 1 — Off-chain (Current)
- Fully playable browser game
- localStorage high scores

### Phase 2 — On-chain Scores
- Deploy `NaddieJump.sol` on Monad testnet
- Submit scores via `viem`
- On-chain leaderboard

### Phase 3 — Economy
- ERC-20 `$GWEI` token rewards
- NFT skins for Naddie
- Daily on-chain tournaments

---

## 🎨 Credits

- Character & art concept: user-provided sprite sheet
- Engine: [Phaser 3](https://phaser.io)
- Font: [Press Start 2P](https://fonts.google.com/specimen/Press+Start+2P)

---

## 📄 License

MIT — built for the Monad ecosystem.
