KO
|
EN
gitlite — search
Search
#javascript
#python
#hacktoberfest
#react
#ai
#typescript
#llm
#go
#golang
#android
#machine-learning
#rust
#deep-learning
#linux
geohunt
★ 15
Open GitHub ↗
Geohunt -:)
Download README (.md)
Explore Similar Repositories
GameText-Plus
:
GameText+ enhances GameText features
awesome-selfhosted-nixos
:
Example configurations for self-hosting stuff on NixOS
Simple-Atlas-Generator
:
Simple Atlas Generator for Unity
gophish-deploy
:
GoPhish-Deploy is an automated deployment script for the GoPhish phishing framework, configuring it with SSL and secure defaults.
FIE2025
:
No description available.
// repository documentation
Was this content helpful?
★ 0
(0 ratings)
Select Rating:
★
★
★
★
★
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
geohunt
?
Download (.md)
# GeoHunt 🌍 ## 📑 Table of Contents - [Overview](#overview) - [Features](#-features) - [How It Works](#-how-it-works) - [Game Flow](#-game-flow) - [Team System](#-team-system) - [Technical Stack](#️-technical-stack) - [Getting Started](#-getting-started) - [Prerequisites](#prerequisites) - [Installation](#installation) - [Key Features Explained](#-key-features-explained) - [Team Formation](#team-formation) - [Gameplay Mechanics](#gameplay-mechanics) - [User Experience](#user-experience) - [Mobile Support](#-mobile-support) - [Contributing](#-contributing) ## Overview GeoHunt is an interactive geography game that combines exploration, learning, and team collaboration. Players can explore global landmarks and landscapes while competing individually or as part of a team.  ## 🎮 Features - **Team Play**: Create or join teams with shared usernames - **Global Exploration**: Discover and learn about worldwide locations - **Lives System**: Strategic gameplay with 5 lives per session - **Collaborative Learning**: Share knowledge and strategies with team members - **Real-time Leaderboard**: Track team progress globally ## 🔄 How It Works ```mermaid flowchart TD A[Start Game] --> B{New or Existing User?} B -->|New| C[Create Username/Team] B -->|Existing| D[Login] C --> E[Game Session] D --> E E --> F[View Location] F --> G[Make Guess] G --> H{Correct?} H -->|Yes| I[Score Points] H -->|No| J[Lose Life] J --> K{Lives Left?} K -->|Yes| F K -->|No| L[Game Over] I --> F ``` ## 🎯 Game Flow 1. **Start**: Choose between creating a new team or joining an existing one 2. **Play**: View locations and make educated guesses 3. **Score**: Earn points for correct guesses 4. **Lives**: Manage your 5 lives carefully 5. **Leaderboard**: Compare your team's performance globally ## 🤝 Team System ```mermaid graph LR A[Team Creation] --> B[Shared Username] B --> C[Multiple Players] C --> D[Individual Games] D --> E[Shared Score Pool] E --> F[Global Leaderboard] ``` ## 🛠️ Technical Stack - React.js for frontend - Tailwind CSS for styling - Nodejs and Express for backend sever - Used Cursor and Claude in the later stages of development ## 🚀 Getting Started 1. Clone the repository ```bash git clone https://github.com/vishdadhich092004/geohunt.git ``` 2. Install backend dependencies ```bash cd geohunt cd client npm install ``` 3. Install backend dependencies ```bash cd .. cd server npm install ``` 5. Start the backend server ```bash cd server npm run dev ``` 5. Start the frontend server ```bash cd client npm run dev ``` ## 💡 Key Features Explained ### Team Formation - Create unique team names - Share credentials with team members - Collaborative score accumulation - Real-time progress tracking ### Gameplay Mechanics - 5 lives per session - Strategic guessing system - Global location database - Interactive map interface ### User Experience - Smooth animations - Intuitive controls - Responsive design - Real-time feedback ## 📱 Mobile Support GeoHunt is fully responsive and works seamlessly across: - Desktop browsers - Tablets - Mobile devices ## 🤝 Contributing We welcome contributions! Please feel free to submit a Pull Request. Thanks to my friends :)
