codergautam / worldguessr

Free & Open source version of Geoguessr

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!

Join the Discord community

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, which is completely free compared to the costly SDK used by GeoGuessr.

Acknowledgements

• OpenStreetMap
• OpenLayers
• Google Maps API
• Next.js
• All contributors who helped bring this project to life!

Running Locally

Prerequisites

Before you start, ensure you have the following installed:

• Node.js (v12.x or later)
• npm (v6.x or later)
• pnpm (v8.x or later)

Installation

1. Clone the repository:

   git clone https://github.com/codergautam/worldguessr.git
   cd worldguessr

2. Install dependencies:

   pnpm install

3. Run the development server:

   pnpm run dev

   Open 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 to discuss new features, report bugs, talk to the developers and connect with other players.

You can email me privately at [email protected]

worldguessr's Issues

Suggestion - Allow to hide the map whenever you are not ready to make a guess

The map is always present which leads to terrible UX. In Ipads the game is virtually unplayable because the Map is always in first plane covering pretty much the whole screen

Pease add a button to toggle the map for guessing being visible or not.

Feat: Add places

Can you add places as well currently game always drops us to random road it would be fun if game gives hs famous place or something like that

Road Names Visible

The road names are visible on Google Maps Street View, making it very easy to guess the location. (Usually <100km)

Suggestion: Other distance units

Low priority probably, but maybe add miles or something too (and kilometers under the miles, or besides it)

Mobile scrolling bug

When scrolling on mobile the map scrolls down as if there is content below.

https://youtube.com/shorts/bDXKbU0Iru8?si=YNvhMTlSdSIZPDSY

Suggestion: Resolve the round whenever all players have guessed

Right now whenever all players have marked their guess (which is irreversible) we all still have to wait for the timer to tick down. The game should resolve at this point and show the round result.

Suggestion - Remove trekker coverage

I find issue in the fact that a lot of times I play, I get a lot of trekker coverage. (where people, not streetview cars take panoramas) I find this quite annoying since it's quite hard to pinpoint where you are being in buildings. Playing normal GeoGuessr I don't get this issue and it is much more fun to play.

Implement a keep alive mechanism

if a network error occurs and websocket disconnects, onclose is not fired. implement a pong mechanism where the client has to send a pong every 10 seconds to server and if there is no pong in the last 60 seconds the clinet is disconnected