hackquest logo

DuelCraft

Blockchain-powered 1v1 fighting game on Mantle with NFT characters, dual-token economy, real-money cash duels, marketplace, tournaments, and season passes. Play to earn and compete!

Videos

Description

DuelCraft is a blockchain-powered 1v1 fighting game built on Mantle Network, combining real-time PvP combat with Web3 economics. Players mint unique character NFTs, compete in skill-based battles, and earn rewards through multiple game modes.

KEY FEATURES:

šŸŽØ Dynamic Character NFTs

• Mint Warriors or Mages as ERC-721 NFTs on Mantle

• Global rarity - each character type can only be minted once

• On-chain stat tracking: Level, XP, wins, losses, total matches

• Visual customization with body colors, hairstyles, outfits, effects

šŸ’° Dual Token Economy

• Arena Coins (off-chain): Earned from matches, spent in cosmetics shop

• ARENA Tokens (ERC-20): Used for NFT marketplace, tournaments, season passes

• MNT Tokens (native): Used for high-stakes cash duels

šŸ’ø Cash Duel System

• Three tiers: Bronze (2 MNT), Silver (10 MNT), Gold (20 MNT)

• Winner takes 90%, 10% platform fee

• Player protection: Daily limits (10 duels/day), 5-min cooldowns, emergency withdrawals

• Anti-cheat mechanisms with server-authorized results

šŸŖ NFT Marketplace

• Buy/sell cosmetic NFTs with ARENA tokens

• Rental system with flexible periods (1, 7, 30 days)

• Categories: Skins, Effects, Emotes, Accessories

• Trustless smart contract execution

šŸ† Tournament System

• Weekly tournaments with ARENA entry fees

• Prize pool distribution: 60% / 25% / 15%

• Single elimination brackets

• Hall of Champions tracking

• NFT badges for winners

šŸŽŸļø Season Pass

• 5-tier progression: Bronze → Diamond

• XP and coin multipliers (up to 2.5x)

• Exclusive rewards and perks

• Purchased with ARENA tokens

āš”ļø Real-time PvP Combat

• WebSocket-based matchmaking

• Phaser.js game engine with smooth animations

• Character actions: Idle, Walk, Jump, Punch, Special Attacks

• Match results automatically recorded on blockchain

TECHNICAL STACK:

• Frontend: React 19, Phaser.js, TailwindCSS, Ethers.js

• Backend: Node.js, Express, WebSocket, TypeScript, MongoDB

• Smart Contracts: Solidity 0.8.20 on Mantle Testnet

• 6 deployed smart contracts with full integration

DuelCraft showcases Mantle's capabilities by leveraging its low gas fees for frequent on-chain interactions while maintaining a seamless gaming experience.

Progress During Hackathon

Built a complete end-to-end blockchain gaming platform on Mantle Network: āœ… Smart Contract Development • Developed and deployed 6 smart contracts on Mantle Testnet • Implemented CashDuel system with MNT wagering (3 tiers) • Created ERC-20 ARENA token economy • Built ERC-721 NFT character system with on-chain metadata • Developed Marketplace with buy/sell/rent functionality • Implemented Tournament and Season Pass contracts • Added server authorization for anti-cheat protection āœ… Backend Infrastructure • Built Node.js/TypeScript server with WebSocket support • Implemented real-time matchmaking engine • Created blockchain integration service with ethers.js • Developed MongoDB schema for off-chain data • Built RESTful API for profiles, matches, and cash duels • Implemented JWT authentication system āœ… Frontend Development • Created React-based UI with 10+ pages • Integrated Phaser.js game engine for combat • Built character creation and customization system • Developed Hub, Shop, Marketplace, Tournament interfaces • Implemented MetaMask wallet integration • Created real-time balance tracking for 3 currencies • Built responsive design with TailwindCSS āœ… Game Mechanics • Developed real-time PvP combat with animations • Implemented matchmaking and lobby system • Created dual game modes: Casual Arena and Cash Duels • Built progression system with XP and leveling • Added cosmetics shop with rarity tiers āœ… Testing & Deployment • Deployed all contracts to Mantle Testnet (Chain ID: 5003) • Verified contract integrations • Tested cash duel flows with MNT • Validated NFT minting and trading • End-to-end testing of all features

Tech Stack

React
Web3
Ethers
Solidity
Node

Fundraising Status

No fundraising yet / Bootstrapped

Sector
GamingNFT

Builders Also Viewed