zkTitans - Crash Bandicoot Battle Card Game

A Web3 battle card game inspired by Crash Bandicoot: Crash of the Titans. Battle with randomly generated cards on the zkSync Sepolia testnet. Built with Vyper smart contracts and a React frontend.

🌐 Live Site: zktitans.site

Tech Stack

Backend - Primary

• Smart Contract: Solidity
• Foundry smart contract testing and development framework
• Network: zkSync Sepolia Testnet
• Features:
  • ERC1155 token implementation
  • Random card generation
  • Battle system with attack/defense mechanics
  • Dynamic stat generation
  • Player registration and management

Backend - Alternative

• Smart Contract: Vyper 0.4.0
• Python Deployment
• Moccasin smart contract testing and development framework
• Network: zkSync Sepolia Testnet
• Features:
  • ERC1155 token implementation
  • Random card generation
  • Battle system with attack/defense mechanics
  • Dynamic stat generation
  • Player registration and management

Frontend

• Framework: Vite - React & JavaScript
• Styling: Tailwind CSS
• Web3 Integration: ethers
• Key Features:
  • Metamask wallet integration
  • Battle interface
  • Card visualization
  • Player stats tracking

Core Features

1. Card System

• 30 unique character cards
• Random stats generation
• Attack and defense attributes

2. Battle Mechanics

• Player vs Player battles
• Attack and defense moves
• Mana management system
• Health point tracking

3. Game Flow

• Player registration
• Random card assignment
• Battle creation and joining
• Move selection and resolution

Smart Contract Features

• ERC1155 token standard
• Random number generation
• Battle state management
• Player state tracking
• Event system for game actions

Getting Started

1. Connect your MetaMask wallet
2. Switch to zkSync Sepolia testnet
3. Register as a player
4. Receive your random character card
5. Create or join battles

Contract Architecture

• Player registration and management
• Battle creation and resolution
• Token management
• Game state handling

Contract Deployment

🔍 View on zkSync Sepolia Explorer - Solidity Version (Primary): 0xdB91eF2587aE0521262fe854D75d6Afa70bF759D

🔍 View on zkSync Sepolia Explorer - Moccasin Version (Alternative): 0xFf115434745F98986e7D2501905EfC788A1aD840

License

MIT

Disclaimer

This is a personal, non-commercial fan project inspired by Activision's Crash Bandicoot franchise. Not affiliated with, endorsed by, or connected to Activision Publishing, Inc.