XION Speed Rush 2D 🏎️
A high-speed 2D racing game built on the XION ecosystem, combining the excitement of arcade racing with blockchain technology. The game leverages XION's infrastructure to deliver seamless, wallet-free, and gas-free user experiences through account abstraction, interoperability, and token-agnostic transactions.
🎮 Live Demo
🎮 Related Repositories
- 🎮 Unity Game Repository - Core game mechanics and physics
- 🔧 Backend API Repository - AI-powered vehicle generation service
- ⛓️ Smart Contracts Repository - Blockchain contracts for the game
🎮 Main Features
🚗 NFT Vehicle System
- AI Generation:
- Each vehicle is uniquely generated by an AI agent using customizable prompts
- Visual styles: Cartoon, Realistic, Anime
- Automatic background removal for sprites
- Stored on IPFS via Lighthouse
🔧 Interchangeable NFT Parts
- Engine:
- Affects speed and acceleration
- Stats: Power, Efficiency, Durability
- Transmission:
- Influences handling and speed shifts
- Stats: Shift Speed, Control, Efficiency
- Core:
- Defines the base vehicle characteristics
- Stats: Handling, Drift, Grip
🏁 Racing System
- Game Modes:
- Time Trial: Compete for the best times
- Daily challenges with prize accumulation
- Special tournaments with guaranteed prizes
- Mechanics:
- Optimized 2D arcade physics
- Drifting and diverse tracks
- Lap system and leaderboard result tracking
- Prize Distribution:
- Results are recorded as NFTs on XION, proving your achievements
- Prize pool distribution:
- 1st place: 40%
- 2nd place: 20%
- 3rd-10th places: 20% distributed equally (~2.5% each)
- 20% allocated to community funds and development
💰 Game Economy
- XION GRASS Token:
- Native game token used for:
- Minting vehicles
- Buying/selling in the marketplace
- Vehicle repairs
- Participating in special events
- Native game token used for:
- Marketplace:
- Vehicle and parts listing
- Offer system
- Advanced search filters
- Transaction history
- Configurable commission (default 2.5%)
🚀 Detailed Technologies
Frontend
- React + TypeScript:
- State management with custom services
- Reusable components
- Routing system with React Router
- Type safety with TypeScript
Backend (API)
- FastAPI + Python:
- Sprite generation with Stability AI v2beta
- Image processing with PIL and rembg
- IPFS storage via Lighthouse
- Parallel processing using asyncio
Game Engine
- Unity WebGL:
- Optimized 2D top-down physics
- Efficient asset management
- Web3 bidirectional communication
Blockchain (XION Network)
- Deployed Contracts:
- CarPart:
xion1jleg22pemep9gtw8s64xn7ham030xffusy484jvf27y76fll6xvqe5nfx6 - CarNFT:
xion14836hqy3km4sardm2e89s2tw6l23d9lvcfwgjwlvp44lztlxjp4q3h5uck
- CarPart:
🛠️ Condition System
- Cars start with 100% condition
- Condition degrades by 5% per race
- Repairs are available in the workshop for a fee
- Condition directly impacts performance
🌟 Why XION?
XION enables a fully seamless experience for everyday users with:
- Protocol-level account abstraction
- Gas-free transactions and familiar payment options
- Cross-chain interoperability for truly decentralized applications
🔧 Setup
- Clone the repository
git clone https://github.com/rofergon/Speed-Rush-2D
- Install dependencies
npm install
- Configure environment variables
VITE_RACE_LEADERBOARD_ADDRESS=<contract_address>
VITE_CAR_NFT_ADDRESS=<contract_address>
VITE_PART_NFT_ADDRESS=<contract_address>
VITE_MARKETPLACE_ADDRESS=<contract_address>
VITE_GARAGE_ADDRESS=<contract_address>
VITE_XION_NETWORK_HUB=<hub_address>
- Start development server
npm run dev
📝 License
MIT License - see the LICENSE file for details.
🤝 Contributions
Contributions, issues, and feature requests are welcome! Feel free to check the issues page.
Contribution Guidelines
- Fork the project
- Create your feature branch (
git checkout -b feature/NewFeature) - Commit your changes (
git commit -m 'Add new feature') - Push to the branch (
git push origin feature/NewFeature) - Open a Pull Request
Join the future of blockchain racing with XION Speed Rush 2D. 🚀