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

No packages published