First true omnichain gaming platform with provably fair battles and dynamic NFT evolution
🎯 QTE Combat System - Timing-based skill mechanics (PERFECT = 2.5x damage!)
🛡️ Defensive Actions - Block (80% reduction) or Parry (90% + counter attack)
📈 Dynamic NFTs - Characters evolve with wins, permanent on-chain stat boosts
⚔️ Provably Fair - Deterministic combat + Chainlink VRF integration ready
🏆 Tournament Mode - Compete for prize pools with entry fees
🔗 Omnichain Ready - Multi-chain architecture (Polygon → Ethereum → Arbitrum)
🎨 P2P Marketplace - Trade NFTs with smart contract escrow + 5% fee
Battle Flow: Mint → Arena → QTE Combat → Win → Stats Grow → Trade
Combat System:
- 15 unique moves (Physical, Special, Ultimate, Defensive, Support)
- Energy-based turn system (120 max, regenerate 25/turn)
- QTE timing windows for damage multipliers
- Defensive reactions (Block/Parry) against enemy attacks
- Dynamic difficulty based on opponent stats
NFT Evolution:
- Win = +2-5 Attack, +1-3 Defense, +1-2 Speed
- Permanent on-chain stat updates
- Battle history tracked per character
- Rarity determines base stats
Smart Contracts: Solidity 0.8.20+ | Foundry/Forge | OpenZeppelin
Blockchain: Polygon Amoy Testnet (Chain ID: 80002)
Frontend: React 18 + Vite 5 | TailwindCSS | Framer Motion
Web3: Wagmi v2 | RainbowKit | Viem
Randomness: Deterministic + Chainlink VRF (planned)
Deployed Contracts:
InceptionCharacters.sol - ERC-721 NFT minting with dynamic metadata
BattleCore.sol - Battle resolution engine with stat updates
InceptionMarketplace.sol - P2P trading with escrow system
Marketplace.sol - Additional marketplace utilities
Deployment Info:
Check contracts/broadcast/Deploy.s.sol/80002/run-latest.json for addresses and tx hashes.
Prerequisites: Node.js 18+ | Foundry | MetaMask with Polygon Amoy MATIC
Installation:
git clone https://github.com/diiviikk5/Inception.git cd Inception npm install npm run dev
.
Deploy Contracts:
cd contracts forge build forge script script/Deploy.s.sol --rpc-url $AMOY_RPC_URL --broadcast --verify
.
Test Contracts:
forge test -vvv
.
- Connect Wallet - RainbowKit modal with multi-wallet support
- Claim Starter - 3 FREE NFT characters (Shadow Warrior, Flame Knight, Cyber Mage)
- Enter Arena - Select character and face AI opponents
- QTE Combat - Click during timing windows for Perfect/Great/Good bonuses
- Defensive Phase - Block or Parry incoming attacks
- Win Rewards - Stats automatically update on-chain
- Trade NFTs - List on marketplace or buy stronger characters
Phase 1 - Current ✅
Core game mechanics, frontend demo, smart contracts deployed
Phase 2 - Q1 2026
Chainlink VRF integration, tournament smart contracts, NFT rental system
Phase 3 - Q2 2026
Multi-chain deployment (Ethereum, Arbitrum, Base), cross-chain bridging
Phase 4 - Q3 2026
Mobile app (React Native), esports partnerships, DAO governance
⚡ First timing-based blockchain combat - QTE system with 2.5x damage multipliers
🔮 Dynamic NFT evolution - Stats permanently grow on-chain
🌐 True omnichain architecture - Asset portability across multiple chains
🎲 Provably fair battles - Deterministic + verifiable randomness
💎 Skill-based progression - Timing and strategy beats pure luck
Built by passionate Web3 developers pushing the boundaries of blockchain gaming.
MIT License - See LICENSE file for details
Play Now • View Code • Read Whitepaper
Star ⭐ this repo if you believe in the future of blockchain gaming!
Contracts:
- InceptionCharacters.sol (ERC-721 NFT)
- BattleCore.sol (Battle resolution)
- InceptionMarketplace.sol (P2P trading)
Deployment info: See contracts/broadcast/ folder for addresses and tx hashes
Character metadata/images: Hosted on GitHub at public/characters/