🗺️ MineGuessr

GeoGuessr, but inside Minecraft. You're teleported to a completely random spot in the world with no idea where you are. Look around, study the terrain, the biome, the sun, the structures — then open the map and pin exactly where you spawned. The closer your guess, the more points you score.

Every location is real, procedurally generated Minecraft terrain, so no two rounds are ever the same.

⚠️ Beta / test release. Bug reports and feedback are hugely appreciated!

---

✨ Features

🎯 The core game

• You spawn at a random point inside a 150-block region, bounded by a world border.
• After a short timer, an interactive map of the region opens.
• Click where you think you spawned. Score is distance-based (a bullseye = 5000 points), exactly like GeoGuessr.

🧑‍🤝‍🧑 Single-player & Multiplayer

• Play solo, or with friends — every online player joins automatically.
• In multiplayer, everyone is dropped at the same location each round and guesses independently.
• The round result is only revealed once everyone has guessed, so nobody can copy another player's pin.
• Cumulative scoreboard across rounds, with player heads and names.

🎚️ Difficulties (in-game menu)

Run /geo start to open the selection screen:

Difficulty	Move	Time	Effects
🟢 Easy	Free	10s	—
🟡 Normal	Frozen	10s	—
🟠 Hard	Frozen	5s	—
🔴 Insane	Free	5s	Blindness
🟣 Mega Insane	Free	5s	Blindness + Night
🛠️ Custom	—	—	Toggle movement, blindness, day/night, time & rounds

🧭 A proper map screen

• Zoom (scroll) and pan (drag) the map.
• Battleship grid with A–H columns and 1–8 rows for easy communication ("it's in C5!").
• Compass (N) and a Sun/Moon indicator (East/West) for orientation.
• Scale bar and structure markers (villages, pillager outposts, pyramids, and more).
• Snow, ice, water depth and terrain relief are all rendered.

🏆 Results, history & records

• A polished end-of-match results panel ranking all players.
• 🎆 Fireworks when someone nails a perfect 0-block guess.
• Full match history with Multiplayer / Single-player tabs.
• Click any past match to review the maps — see where every player pinged each round and how far off they were. Maps are saved as images, so reviews work anytime.

🛡️ Built-in anti-cheat

• Players are invisible and non-colliding to each other.
• F3 coordinates hidden, block breaking/placing disabled, and you're invulnerable during a match.

---

🎮 How to play

Command	Description
/geo start	Open the difficulty selection menu
/geo start <difficulty> [rounds]	Quick-start a preset (e.g. /geo start hard 3)
/geo history	Browse past matches and review their maps
/geo records	Show records
/geo stop	End the current match

On the map: left-click to place your pin · right-click to clear it · scroll to zoom · drag to pan · then confirm.

---

📦 Requirements

• Minecraft 1.21.11
• Fabric Loader 0.19.3+
• Fabric API

Install on both client and server (or on the host for LAN / Open-to-LAN games).

---

Made for the Minecraft community. Have fun getting lost! 🌍