Flappy Bird GameFi

A blockchain-based version of the classic Flappy Bird game with GameFi elements, built on the Tea Sepolia network.

🎮 Game Overview

Flappy Bird GameFi combines the addictive gameplay of the original Flappy Bird with blockchain technology and play-to-earn mechanics. Players can:

• Play the classic Flappy Bird game
• Earn FLP tokens through gameplay
• Buy tickets using TEA tokens
• Claim rewards based on their performance

🛠️ Technical Stack

Frontend

• HTML5 Canvas for game rendering
• JavaScript for game logic
• Web3.js for blockchain interaction
• Web3Modal for wallet connection
• jQuery for UI components

Blockchain

• Tea Sepolia Network
• Smart Contracts for game logic and token management
• Web3 integration for transactions

📋 Prerequisites

Before you begin, ensure you have:

• MetaMask or a compatible Web3 wallet installed
• TEA tokens in your wallet for purchasing game tickets
• Network configured for Tea Sepolia (Chain ID: 10218)

🚀 Installation

1. Clone the repository:

git clone https://github.com/your-username/flappy-bird-gamefi.git
cd flappy-bird-gamefi

2. Install dependencies:

npm install

3. Start the development server:

npm start

4. Open your browser and navigate to:

http://localhost:3000

💰 Game Economics

Tokens

• TEA: Native token used for purchasing game tickets
• FLP: Game token earned through gameplay
• Tickets: Required to play the game

Pricing

• 1 Ticket = 1 TEA
• Rewards are distributed in FLP tokens based on performance

🎯 How to Play

1. Connect Your Wallet

   • Click the "Connect Wallet" button
   • Approve the connection in your wallet
   • Ensure you're on the Tea Sepolia network

2. Buy Tickets

   • Click "Buy Ticket" in the wallet interface
   • Enter the number of tickets you want to purchase
   • Confirm the transaction in your wallet

3. Start Playing

   • Click "Start Game" to begin
   • Use Spacebar or tap to make the bird flap
   • Navigate through pipes to earn points
   • The game ends when you hit a pipe or the ground

4. Claim Rewards

   • After the game ends, click "Claim Reward"
   • Confirm the transaction in your wallet
   • Your FLP tokens will be sent to your wallet

🔒 Security Features

• Smart contract audits
• Secure wallet integration
• Gas optimization
• Error handling for failed transactions
• Network validation

📊 Game Statistics

• High scores are stored on-chain
• Player statistics are tracked
• Leaderboard functionality

🐛 Known Issues

• Network congestion may affect transaction times
• Gas fees may vary based on network conditions
• Some wallets may require manual network addition

🔄 Updates and Maintenance

Regular updates include:

• Performance optimizations
• New features
• Bug fixes
• Security patches

🤝 Contributing

We welcome contributions! Please follow these steps:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Original Flappy Bird game concept
• Tea Network for blockchain infrastructure
• Web3 community for tools and libraries

📞 Support

For support, please:

• Open an issue in the GitHub repository
• Join our Discord community
• Contact us at [email protected]

🔗 Links

• Website
• Documentation
• Smart Contract
• Twitter
• Discord