https://github.com/seen-design-lab/ecoquest
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.
https://github.com/seen-design-lab/ecoquest
css css3 game game-development htm html-css-javascript html5 js seendesignlab
Last synced: about 2 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/seen-design-lab/ecoquest
- Owner: Seen-Design-Lab
- License: mit
- Created: 2025-02-14T21:56:48.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-14T23:15:16.000Z (over 1 year ago)
- Last Synced: 2025-02-15T00:23:17.875Z (over 1 year ago)
- Topics: css, css3, game, game-development, htm, html-css-javascript, html5, js, seendesignlab
- Language: HTML
- Homepage: https://seen-design-lab.github.io/EcoQuest/
- Size: 299 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🌿 EcoQuest: The Green Adventure
[](https://opensource.org/licenses/MIT)
[](https://github.com/wowrakibul/ecoquest)
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:
```bash
git clone https://github.com/wowrakibul/ecoquest.git
cd ecoquest
```
2. Set up a local development server:
- Using Python:
```bash
python -m http.server 8000
```
- Using Node.js:
```bash
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](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
[](https://github.com/wowrakibul)