106 lines
2.8 KiB
Markdown
106 lines
2.8 KiB
Markdown
# 🚀 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!
|
||
|
||
|
||
|
||
---
|
||
|
||
## 🎮 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.
|