Skip to content

AkatsukiLabs/DuckHunter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🦆 Duck Hunter

A retro-style fully on-chain game built for the Cavos Mini-Hackathon using the Aegis-V1 SDK. Experience the classic duck hunting gameplay with modern fully on-chain integration on Starknet mainnet.

🎮 About

Duck Hunter is a nostalgic pixel-art game that brings the classic duck hunting experience fully on-chain. Players can hunt ducks, earn points, and compete on a global leaderboard powered by Starknet mainnet technology.

This project was created as part of the Cavos Mini-Hackathon using their Aegis-V1 SDK for seamless fully on-chain integration.

🤝 Collaboration

This project was built in collaboration with Marco Araya, who developed the smart contracts that power the game's fully on-chain features. You can find the contracts repository at: https://github.com/AkatsukiLabs/DuckHunter-Contracts

✨ Features

  • Classic Gameplay: Authentic duck hunting mechanics with pixel-perfect graphics
  • Fully On-Chain: Score tracking and player stats stored entirely on Starknet mainnet
  • Global Leaderboard: Compete with players worldwide using real on-chain data
  • Wallet Authentication: Secure login via Google OAuth + Starknet wallet
  • Real-time Transactions: Every successful hunt is recorded on Starknet mainnet
  • Responsive Design: Play on desktop or mobile devices

🛠 Tech Stack

  • Frontend: React + TypeScript + Vite
  • Game Engine: KAPLAY (modern successor to Kaboom.js)
  • Fully On-Chain: Starknet mainnet + Dojo Engine
  • Authentication: Cavos SDK (Aegis-V1)
  • State Management: Zustand
  • Routing: React Router
  • Styling: CSS-in-JS with pixel-perfect retro design

🎯 Hackathon Context

Built for the Cavos Mini-Hackathon showcasing:

  • Integration with Cavos Aegis-V1 SDK
  • Starknet mainnet interaction
  • Modern fully on-chain dApp development practices
  • Classic gaming meets Web3

🎮 How to Play

  1. Connect Wallet: Sign in with Google and connect your Starknet wallet
  2. Enter Username: Choose your hunter name
  3. Start Hunting: Click on ducks that fly across the screen
  4. Earn Points: Each successful hit earns points and increases your kill count
  5. Climb the Leaderboard: Compete globally with other hunters

🏆 Game Mechanics

  • 3 bullets per duck: Make your shots count!
  • Progressive difficulty: Rounds get faster as you advance
  • Scoring system: Different point values for various achievements
  • Fully On-Chain Persistence: All stats saved permanently on Starknet mainnet

📱 Deployment

The game is optimized for deployment on Vercel with automatic SPA routing configuration.

🤖 Smart Contracts

The game's fully on-chain functionality is powered by smart contracts developed by Marco Araya. Check out the contracts repository for technical details: https://github.com/AkatsukiLabs/DuckHunter-Contracts

📄 License

This project is part of the Cavos Mini-Hackathon and serves as a demonstration of fully on-chain gaming capabilities.

Releases

No releases published

Packages

 
 
 

Contributors