lothanuelubah93/African-Ancestral-Spirits

## 🚀 Quick Start (For Judges & Developers) Follow these steps to run the project on your local machine. # 1. Clone the repository git clone github.com cd African-Ancestral-Spirits # 2. Install all dependencies npm install # 3. Create your environment file Create a new file in the main folder named `.env` # 4. Add your API keys to the .env file Copy and paste the following into your new `.env` file, adding your own keys: VITE_ELEVENLABS_API_KEY=your_key_here VITE_HEDERA_ACCOUNT_ID=your_account_id # 5. Run the development server npm run dev 🎮 Game Overview 5 Unique Levels. 5 African Countries. 1 Epic Adventure. Level Country Genre Features 🇪🇬 Egypt Curse of the Pharaohs 2D Exploration Collect spirits (Ammit, Apep, Ba), Ra's Blessing power 🇪🇹 Ethiopia Devil Battle 3D FPS Boss Fight Holy fire combat, Ethiopian Orthodox chants, 500 HP boss 🇸🇳 Senegal Dogon Star Wars 2-Player Shooter Character selection, alien combat, Afrobeat audio 🇳🇬 Nigeria Multi-Temple Hunt 3D Exploration 4 temples (Yoruba/Igbo/Benin/Hausa), cultural artifacts 🇰🇪 Kenya Maasai Survival 3D Action Spear throwing, beast hunting, warrior mechanics ✨ Key Features 🎯 5 Distinct Gameplay Styles - From 2D exploration to 3D boss battles 👥 2-Player Co-op - Senegal level supports local multiplayer 💎 Hedera Blockchain - Earn HBAR rewards, mint spirit NFTs 🎵 AI-Generated Audio - Authentic African sounds via ElevenLabs 🏛️ Educational - Learn real African history and UNESCO heritage sites 🎨 Cultural Authenticity - Dogon masks, Ethiopian crosses, Benin bronzes 🛠️ Tech Stack Frontend: React, Three.js, HTML5 Canvas, Tailwind CSS Blockchain: Hedera SDK, HashConnect, HTS (NFTs) Audio: ElevenLabs API, Web Audio API Deployment: Vercel, Itch.io ### Hedera Services Used * **Hedera Token Service (HTS):** Used for minting our 375+ unique Spirit and Artifact NFTs. * **HBAR Transfers:** Used for distributing instant HBAR rewards to players for completing levels and col …