Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/codergautam/worldguessr
Free & Open source version of Geoguessr
https://github.com/codergautam/worldguessr
educational-game game geography geoguess geoguessr google-maps googlemaps-api multiplayer-game streetview web-game web-games webgame
Last synced: 2 months ago
JSON representation
Free & Open source version of Geoguessr
- Host: GitHub
- URL: https://github.com/codergautam/worldguessr
- Owner: codergautam
- License: mit
- Created: 2024-04-14T19:46:53.000Z (10 months ago)
- Default Branch: master
- Last Pushed: 2024-11-23T03:48:56.000Z (2 months ago)
- Last Synced: 2024-11-23T04:28:47.415Z (2 months ago)
- Topics: educational-game, game, geography, geoguess, geoguessr, google-maps, googlemaps-api, multiplayer-game, streetview, web-game, web-games, webgame
- Language: JavaScript
- Homepage: https://worldguessr.com
- Size: 27.1 MB
- Stars: 93
- Watchers: 1
- Forks: 43
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
[](https://worldguessr.com)
A free and open-source version of the popular geography game inspired by GeoGuessr. This project is built with Next.js and aims to provide a fun and educational way to explore the world through random street views.
### Play now [here](https://worldguessr.com)!
#### [Join the Discord community](https://discord.gg/yenVspFmkB)
## Features
- **Random Street Views:** Experience a new location anywhere in the world on each game.
- **Multiplayer Mode:** Challenge your friends or play against random opponents in real-time.
- **Country Streaks:** Test your knowledge and see how many countries you can guess in a row.
- **Free to run:** The project is open-source and free to run on your own server. Uses the [Google Maps Streetview Embed API](https://developers.google.com/streetview/web), which is completely free compared to the costly SDK used by GeoGuessr.
## Acknowledgements
- [OpenStreetMap](https://www.openstreetmap.org/)
- [OpenLayers](https://openlayers.org/)
- [Google Maps API](https://developers.google.com/maps)
- [Next.js](https://nextjs.org/)
- All contributors who helped bring this project to life!
## Running Locally
### Prerequisites
Before you start, ensure you have the following installed:
- [Node.js](https://nodejs.org/en/) (v12.x or later)
- [npm](https://www.npmjs.com/) (v6.x or later)
- [pnpm](https://pnpm.io/) (v8.x or later)
### Installation
1. Clone the repository:
```bash
git clone https://github.com/codergautam/worldguessr.git
cd worldguessr
```
2. Install dependencies:
```bash
pnpm install
```
3. Run the development server:
```bash
pnpm run dev
```
Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
## Contributing
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
Don't forget to give the project a star! Thanks again!
1. Fork the Project
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
Distributed under the MIT License. You are free to use, modify, and distribute this project for personal or commercial use. See `LICENSE.md` for more information.
## Community
Join the Discord community [here](https://discord.gg/yenVspFmkB) to discuss new features, report bugs, talk to the developers and connect with other players.
You can email me privately at [email protected]