Initial commit: Naddie Jump — Monad Edition

README.md

@@ -0,0 +1,105 @@
+# 🚀 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.