🌿 EcoQuest: The Green Adventure

An educational web-based game that combines adventure and environmental awareness, where players become young environmentalists working to save their town from pollution and climate change.

🎮 Game Overview

EcoQuest is an interactive environmental education game that teaches players about sustainability, conservation, and environmental responsibility through engaging gameplay mechanics. Players explore various biomes, complete eco-friendly challenges, and make impactful decisions that affect their virtual world.

🌟 Features

• Multiple Biomes: Explore forests, rivers, and urban areas
• Resource Management: Gather and manage water, seeds, and energy
• Quest System: Complete environmental challenges and missions
• Dynamic Ecosystem: Watch your environment change based on your choices
• Educational Content: Learn about biodiversity, recycling, and conservation
• Multiplayer Elements: Collaborate with friends on environmental projects

🚀 Getting Started

Prerequisites

• Modern web browser (Chrome, Firefox, Safari, or Edge)
• Local development server (recommended)

Installation

1. Clone the repository:

git clone https://github.com/wowrakibul/ecoquest.git
cd ecoquest

2. Set up a local development server:

   • Using Python:

     python -m http.server 8000

   • Using Node.js:

     npx http-server

3. Open your browser and navigate to:

   • Python: http://localhost:8000
   • Node.js: http://localhost:8080

🎯 How to Play

Controls

• Movement: Use WASD or Arrow keys
• Interaction: Press E to interact with objects/NPCs
• Inventory: Press I to open inventory
• Menu: Press ESC to open game menu

Game Objectives

1. Resource Collection

   • Gather water from clean sources
   • Collect seeds from healthy plants
   • Generate and manage sustainable energy

2. Environmental Tasks

   • Plant trees to improve air quality
   • Clean up pollution in various areas
   • Build sustainable infrastructure
   • Rescue and protect local wildlife

3. Community Projects

   • Organize clean-up events
   • Create community gardens
   • Build renewable energy stations
   • Educate virtual townspeople

Scoring System

• Green Points: Earned by completing eco-friendly actions
• Sustainability Rating: Based on resource management
• Community Impact: Measured by completed projects
• Biodiversity Index: Shows wildlife and plant variety

🛠️ Technical Details

Built With

• HTML5 Canvas
• Modern CSS3
• Vanilla JavaScript (ES6+)
• Modular Architecture

Project Structure

ecoquest/
├── index.html          # Main game HTML
├── css/               # Stylesheets
│   ├── style.css     # Global styles
│   ├── game.css      # Game-specific styles
│   └── ui.css        # UI component styles
├── js/               # JavaScript modules
│   ├── main.js       # Game initialization
│   ├── game.js       # Core game logic
│   ├── resources.js  # Resource management
│   ├── quests.js     # Quest system
│   └── ui.js         # UI management
└── assets/           # Game assets
    ├── images/       # Game graphics
    └── sounds/       # Sound effects

🤝 Contributing

We welcome contributions to EcoQuest! Here's how you can help:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

👥 Authors

• @wowrakibul - Initial work and maintenance

🙏 Acknowledgments

• Environmental education resources
• Open-source game development community
• Contributors and testers

🔄 Version History

• v1.0.0 (2025-02-14)
  • Initial release
  • Basic gameplay mechanics
  • First set of environmental challenges

---

Last updated: 2025-02-14 21:53:22 UTC by @wowrakibul