Add docs navigation and tighten API request security

docs/gitbook/README.md

@@ -0,0 +1,29 @@
+# Welcome to MineGeo
+
+Welcome, explorer! MineGeo drops you into a Minecraft view and asks one question: **where are you?** Look for clues, pick a spot on the map, and see how close you got.
+
+> Me: “I know this place.” Also me: guesses on the other side of the map. 🗿
+
+## Just want to play?
+
+1. Open [Play & maps](https://minegeo.vercel.app/servers).
+2. Choose a map.
+3. Choose Easy for a relaxed first game.
+4. Click **Start exploring**.
+
+You can play public maps without an account or Minecraft installed. A game has five rounds. Read **Your first game** in the page menu if you want a walkthrough.
+
+## Find your guide
+
+- **Multiplayer and chat:** invite friends and talk while you play.
+- **Accounts and appearance:** change your name, theme, or glow color.
+- **Windows desktop client:** play in a separate app.
+- **Create and publish a map:** let others explore your Minecraft builds.
+- **Share and import maps:** play a map your friend sent as a ZIP file.
+- **Bug reports and support:** get help when something breaks.
+
+## A small heads-up
+
+You need an internet connection. Sign in to host a party or keep your own maps. These instructions use the English button names; Russian is available in the site's footer.
+
+MineGeo is an independent community project, not affiliated with Mojang or Microsoft.

docs/gitbook/SUMMARY.md

@@ -0,0 +1,15 @@
+# Summary
+
+* [Welcome to MineGeo](README.md)
+* [Your first game](playing.md)
+* [Multiplayer and chat](multiplayer.md)
+* [Accounts and appearance](accounts.md)
+* [Windows desktop client](desktop.md)
+* [Create and publish a map](creating-maps.md)
+* [Capture your Minecraft world](server-plugin.md)
+* [Contribute panoramas](contributions.md)
+* [Share and import maps](map-sharing.md)
+* [Bug reports and support](support.md)
+* [Content reports and appeals](content-reports.md)
+* [Troubleshooting](troubleshooting.md)
+* [Community and badges](staff.md)

docs/gitbook/accounts.md

@@ -0,0 +1,34 @@
+# Accounts and appearance
+
+An account lets you host parties, keep your maps, and return to your support conversations.
+
+## Sign in
+
+Click **Log in** in the header. From there you can sign in, create an account, or recover a forgotten password. Once signed in, the button becomes **My account**.
+
+Your account page lists your maps and recent games. Open **Account settings** to change your name or password.
+
+## Change your name
+
+1. Open **My account → Account settings**.
+2. Find **Display name**.
+3. Enter a name between 2 and 32 characters.
+4. Click **Save display name**.
+
+This is the name people see in multiplayer and map credits. More than one player can have the same name. You still sign in using your email address.
+
+## Choose light or dark mode
+
+Click the sun/moon button in the header or footer. No account is needed. Your browser remembers the choice when it can. The actual map pictures keep their colors.
+
+To change the site language, use **Site language** at the bottom of the page and choose English, Русский, or Automatic.
+
+## Change a glow color
+
+If support has awarded you a username glow, open **Settings → Username glow**, choose a color, and click **Save glow color**. This option needs an active glow reward.
+
+## Forgot your password?
+
+Use password recovery on the login page and follow the email. If the link expires, request a new one. New passwords need at least 12 characters; the page will explain any other requirements.
+
+Never share your password or recovery email link with another player.

docs/gitbook/content-reports.md

@@ -0,0 +1,27 @@
+# Content reports and appeals
+
+If a map or one of its pictures contains a problem, use **Report content**. If a button or the game itself is broken, use **Report a bug** instead.
+
+## Report a map or picture
+
+1. Sign in.
+2. Open the public map page and choose **Report content**. During a game, the same option reports the view you are looking at.
+3. Choose a category and explain what is wrong.
+4. Add a link to evidence if you have one, then send the report.
+
+Be specific and report honestly. You cannot report your own map. If you already have a report waiting on that map, wait for its review rather than sending duplicates.
+
+## What happens next?
+
+An Admin checks the map and the report. Reports do not automatically count against a map. Only confirmed reports add strikes.
+
+Three confirmed strikes from different reporters cause a map to be removed from public play. This affects the map, not the owner's account.
+
+## My map was banned. What can I do?
+
+1. Open **My account** and choose the banned map.
+2. Click **Appeal map ban**.
+3. Explain why it should be reconsidered and include helpful new information.
+4. Wait for the decision. Only one appeal can be waiting at a time.
+
+If approved, the last public version returns and its strike count resets. If rejected, read the feedback before sending another appeal with new information.

docs/gitbook/contributions.md

@@ -0,0 +1,35 @@
+# Contribute panoramas
+
+A panorama is a picture you can look around in all directions. Map owners can let other players add more of these views.
+
+## Ask the owner first
+
+Ask whether contributions are open. Get the map's **map ID** and ask where you should capture. A map ID is the code that tells MineGeo which map you mean.
+
+Capture in the same Minecraft world and inside the area the owner gives you.
+
+## Send your views
+
+1. Open Minecraft with MineGeo's capture mod and connect your own account.
+2. Press **G** and paste the owner's code into **Add to map ID**.
+3. Capture your views and upload them. Even one view can be a contribution.
+4. In MineGeo, open **My account → Open contribution** after the pictures are ready.
+5. Check the pictures, choose what to send, and click **Submit to map owner**.
+
+The owner checks them first. A Moderator or Admin then reviews the map update before the views become public. You can withdraw a contribution while it is still waiting. To add more after it is accepted, make a fresh capture.
+
+## How many can I add?
+
+Each contributor can add up to **12 views in total** to a map. The whole map holds up to **24**, including views waiting to be checked. Accepted views still count toward your limit.
+
+## If the server does not match
+
+Join using the server address the map owner expects. If MineGeo still says it does not match, ask the owner to check it. Do not try to fix unfamiliar server settings yourself.
+
+## For map owners
+
+Open your map's **Panorama settings** and turn on **Allow players to add panoramas with you**. Share the map ID and capture area. Check **Player submissions**, look around the pictures, and accept or reject them with feedback. Save the combined selection and submit the update for review.
+
+## Where did an older contribution go?
+
+After five days, contributions disappear from the dashboard list. They are not deleted. Keep the direct link if you want to return to one later.

docs/gitbook/creating-maps.md

@@ -0,0 +1,34 @@
+# Create and publish a map
+
+Built something worth getting lost in? Turn it into a map for other players.
+
+## The short version
+
+1. Capture views in Minecraft with a MineGeo capture tool.
+2. Upload them to your account.
+3. Check your private map and choose the views you want to use.
+4. Send it for review when it is ready.
+
+Uploading does not immediately make your map public. A **draft** is a map only you can work on before sharing it publicly.
+
+## How do I take the pictures?
+
+Use the MineGeo capture mod from [Downloads](https://minegeo.vercel.app/downloads). A mod is an add-on for Minecraft. It helps you capture views and send them to MineGeo.
+
+Open **Capture your Minecraft world** in these docs for the next steps. If you have never installed a Minecraft mod, ask a friend who has, or your server owner, to help. You do not need a capture tool just to play other people's maps.
+
+## Check your map
+
+After uploading, open **My account**, find your map, and click **Open map**. Wait for the pictures to finish preparing.
+
+Give it a clear name and description. Look all the way around each view: can a player see useful clues? Keep at least **five locations**. A map can hold up to **24**. Save your changes.
+
+> Your beautiful base: 10/10. Your ability to recognize its back wall: 0/10. 😅
+
+## Let everyone play
+
+Click **Submit for review**. A Moderator or Admin will check the map. If they return it, read their feedback, make the changes, and send it again.
+
+While a public map's update is being checked, players can still enjoy its previous approved version. Some editing controls are unavailable during review.
+
+A map imported from a friend's ZIP cannot be submitted as your own. You can play that copy privately instead.

docs/gitbook/desktop.md

@@ -0,0 +1,26 @@
+# Windows desktop client
+
+Want MineGeo in its own window? The Windows app plays the same online game as the website.
+
+## Get the app
+
+1. Open [Downloads](https://minegeo.vercel.app/downloads).
+2. Choose the **Windows x64** download.
+3. When it finishes, open the downloaded MineGeo file. You can usually find it in your Downloads folder.
+4. Play as a guest or sign in to your account.
+
+There is no installation wizard. You need an internet connection. The current app is for Windows; on Mac or Linux, use the website instead.
+
+## A Windows warning?
+
+The current app may show an unknown-publisher warning. Download it only from MineGeo's official Downloads page. If you are unsure about the warning, use the website or ask support for help.
+
+## Updates and sign-in
+
+Website changes appear when the app reloads. When a new desktop app is released, download the new version from Downloads.
+
+The app remembers your sign-in on that computer. Choose **Sign out** when using a shared computer. Removing the downloaded app file does not automatically sign you out.
+
+## If it will not open the game
+
+Check your internet connection and try [MineGeo in your browser](https://minegeo.vercel.app). Tell support whether both versions fail or only the app.

docs/gitbook/map-sharing.md

@@ -0,0 +1,38 @@
+# Share and import maps
+
+Your friend made a map and wants you to try it? They can send you a **ZIP file**: one file containing the map and its pictures. You do not have to open or unpack it yourself.
+
+## Send your own map
+
+1. Sign in as the map's original owner.
+2. Save your changes.
+3. Click **Export ZIP** in your map editor or on its public page.
+4. Send the downloaded file to your friend, for example through a service that accepts files of that size.
+
+Only the original owner can export. The file includes the map's views and locations, so share content you are happy for your friend to receive.
+
+## Play a map your friend sent
+
+1. Download their ZIP to your computer.
+2. Sign in to MineGeo.
+3. Open **Play & maps** and click **Import** beside the search box. You can also find Import in **My account**.
+4. Choose the downloaded ZIP. It must be no larger than **256 MB**.
+5. Wait for MineGeo to prepare it, then open it from your account.
+
+You do not need Minecraft installed. Keep the ZIP as your friend sent it; MineGeo handles opening it.
+
+## What can I do with an imported map?
+
+- Play it privately by yourself.
+- Host a private multiplayer party and invite friends.
+- See the original creator's name next to **Owned by**.
+
+You **cannot publish it, submit it for review, re-export it, or announce its party to Discord**. Private imported games do not add public leaderboard scores. Only the original owner can submit the original map for public review.
+
+You do not need a moderator's approval to import or play the file.
+
+> Friend: “I made an easy map.” The first view: identical trees in every direction. 🌳
+
+## The file will not import
+
+Check the size and make sure you chose the ZIP MineGeo generated. Ask the owner to export a fresh copy if needed. If it still fails, tell support the error you see.

docs/gitbook/multiplayer.md

@@ -0,0 +1,41 @@
+# Multiplayer and chat
+
+Lost together is better than lost alone. Invite friends, play the same five locations, and compare your scores.
+
+## Start a party
+
+1. Sign in to MineGeo.
+2. Open a map and choose **Multiplayer**.
+3. Choose the difficulty and how many players can join, from **2 to 16**, including you.
+4. Create the party, copy the invite link, and send it to your friends.
+5. Start when at least two players have joined.
+
+The host uses their account's **Display Name**. To change it, open **My account → Account settings**. The host can remove players from the lobby before the game starts.
+
+## Join a friend
+
+Open their invite link while the party is still waiting for players and has space. Signed-in players use their account names. Guests can choose a nickname and join without an account.
+
+## Talk while playing
+
+Open **Chat** in the lobby, during a round, or on the results screen. Type a message and send it. An unread badge appears when new messages arrive while chat is closed.
+
+Messages can be up to 500 characters. Chat does not pause the timer, so remember to make your guess! Only people currently in the party can use its chat.
+
+> Friend: “Trust me, it's by the lake.” The map: three lakes. 🤔
+
+## What happens between rounds?
+
+Everyone sees the same locations. Results appear when everyone guesses or time runs out. The host can continue to the next round, or it begins automatically after 20 seconds. Highest total wins; equal scores share a place.
+
+Refreshing the same browser usually brings you back to your player, but the timer keeps running. Leaving during the match gives zero for your remaining rounds.
+
+## Invite the Discord community
+
+On a public map, the host can click **Publish party to Discord**. The invite appears in the community's party channel, where other players can join. You cannot choose another channel. Leave this button alone if you want to invite only your friends.
+
+Private and imported maps cannot be announced publicly. When the party closes, its Discord message turns red and is removed five minutes after the closed notice is delivered.
+
+## If the host leaves
+
+Another signed-in player takes over. If only guests remain, the party closes. Unfinished parties expire after 24 hours. Keep invite links within the group you want to play with.

docs/gitbook/playing.md

@@ -0,0 +1,34 @@
+# Your first game
+
+Your goal is to work out where the view was taken. You do not need to know Minecraft coordinates to enjoy a game.
+
+## Play a round
+
+1. Open [Play & maps](https://minegeo.vercel.app/servers), choose a map, and keep **Solo** selected.
+2. Pick a difficulty and click **Start exploring**.
+3. Drag the picture to look around. You can turn your view, but you cannot walk around.
+4. Look for a mountain, beach, river, road, or interesting building.
+5. Open the small map in the bottom-right corner. Click where you think you are to place a pin.
+6. Move the pin if you change your mind, then submit your guess before time runs out.
+
+## Pick your pace
+
+- **Easy:** 3 minutes per round, with zoom. A good place to start.
+- **Normal:** 90 seconds per round, with zoom.
+- **Hard:** 30 seconds per round, without zoom. Bring your detective hat.
+
+> “Just one more look around.” The timer: 0:01. 💀
+
+## How points work
+
+A closer guess earns more points. You can get up to **5,000 per round** and **25,000 across all five rounds**. If the clock runs out without a guess, that round gets zero. You can still finish the game.
+
+North is at the top of the map. Compare shapes: a bend in a river or the edge of a forest can be easier to spot than a single house.
+
+![Confused Math Lady meme: a puzzled face surrounded by equations](https://i.imgflip.com/6677gf.png)
+
+A familiar reaction when every mountain looks like your mountain. [Meme source: Imgflip](https://imgflip.com/memetemplate/373211007/Confusion).
+
+## See how you did
+
+At the end, compare your guesses with the real locations. Visit the [Leaderboard](https://minegeo.vercel.app/leaderboard) to search for players or choose a difficulty. Your best full-game score is used for ranking. Multiplayer has its own results, and private imported maps do not add leaderboard scores.

docs/gitbook/server-plugin.md

@@ -0,0 +1,36 @@
+# Capture your Minecraft world
+
+This page is for players who want to make a map. If you only want to guess locations, you can skip it!
+
+## Before you start
+
+You need Minecraft Java and the matching MineGeo capture mod from [Downloads](https://minegeo.vercel.app/downloads). The page lists the supported Minecraft versions and what to install alongside it.
+
+If mod installation is new to you, ask a friend or server owner for help with that part. Choose the download matching your Minecraft version. Your server does not need its own MineGeo plugin for you to use the capture mod.
+
+## Capture a new map
+
+1. Open Minecraft with the capture mod installed.
+2. Join the world or server you want to show.
+3. Press **G** to open MineGeo's capture panel.
+4. Follow the sign-in steps to connect your MineGeo account.
+5. For a new map, leave **Add to map ID** empty.
+6. Capture at least **five different viewpoints**, up to 24, then upload.
+7. Return to **My account** on MineGeo and open your map when it is ready.
+
+A viewpoint is the place you stand when taking a view. Spread them around interesting parts of the world so players have something to recognize.
+
+## Pick useful views
+
+- Show landmarks, paths, rivers, hills, and buildings.
+- Check the view is clear rather than completely blocked by a wall.
+- Capture places you have permission to share.
+- Preview the finished pictures before sending the map for review.
+
+## What if my server owner handles maps?
+
+Ask them whether they can make a map with MineGeo's server plugin. You do not need to type server commands or manage the server yourself.
+
+## Adding views to someone else's map?
+
+Read **Contribute panoramas** first. You will need the owner's map ID, which tells MineGeo which map should receive your views.

docs/gitbook/staff.md

@@ -0,0 +1,30 @@
+# Community and badges
+
+Meet other explorers, recognize the people helping the community, and make your account feel like yours.
+
+## Join Discord
+
+Use the Discord button at the bottom of MineGeo, or [join the community here](https://discord.gg/Aer4ZugKWS).
+
+Newly approved maps may be announced there. Hosts can also share open multiplayer parties to the community's party channel. Open an invite to join while there is space.
+
+## What do the name badges mean?
+
+- **Moderator, with a shield:** someone who can check maps and approve them for public play.
+- **Admin, with a crown:** someone who can also handle community reports and other site management.
+- **Bug finder:** someone recognized for helping find a confirmed bug.
+- **Custom prefix:** extra text and an icon assigned by an Admin.
+
+A decorative custom prefix does not give someone moderation powers. Copying another player's name does not copy their badges.
+
+## Can I get a glow?
+
+Support may award one for a confirmed bug report. Describe the real problem through **Report a bug**. A reward is granted by staff; it is not automatic for every report.
+
+If you have an active glow, open **Settings → Username glow**, choose a color, and save it. You can keep an earned Bug finder badge even if the glow is later removed.
+
+## Be a good party member
+
+Share invites thoughtfully, keep chat friendly, and avoid spoiling the location before everyone has guessed. Report content that needs attention instead of starting an argument.
+
+> The real treasure was the friends who also guessed the wrong mountain. ⛰️

docs/gitbook/support.md

@@ -0,0 +1,41 @@
+# Bug reports and support
+
+Found something broken? Tell us what happened so we can help.
+
+## Send a report
+
+1. Click **Report a bug** in the header, or open [Support](https://minegeo.vercel.app/support).
+2. Give it a clear title, such as “The map stays blank when I start a game”.
+3. Describe what you clicked, what you expected, and what happened instead.
+4. Add a screenshot if it helps. You can attach one PNG, JPG, or WebP picture up to **5 MB**.
+5. Click **Send bug report**.
+
+A screenshot is a picture of what is on your screen. On Windows, press **Windows + Shift + S**, select the area, and save the picture before attaching it. Hide private messages, passwords, and other personal information first.
+
+## Example
+
+“I opened a map, chose Normal, and clicked Start exploring. The timer started, but the picture stayed blank. I tried refreshing once. I am playing in the Windows app.”
+
+You do not need technical words or a perfect explanation. Tell us what you saw.
+
+## Read and send replies
+
+Open the report from **Your bug reports** on the support page. Staff replies appear there, and you can send more information in the same conversation. You do not need another app or a separate support account.
+
+If the report says it is still waiting to be delivered, keep an eye on that message. A saved report may not have reached support yet.
+
+## Keep access to your report
+
+Signing in is the easiest way to keep your reports. If you sent one as a guest, return using the same browser. Sign in there and choose **Keep this report in my account**.
+
+Clearing your browser data before linking a guest report may lose access to it.
+
+## Rewards
+
+Staff may award a username glow and **Bug finder** badge for a confirmed bug. If you receive a glow, choose its color in settings. A guest must link the report to an account to receive a pending account reward.
+
+## Finished with the report?
+
+Once support has received it, you can choose **Close report**. Staff can close it too. It becomes **Done** and you cannot send more messages.
+
+**Closed reports, messages, and screenshots are deleted after three days.** The page shows the deletion date. Save anything you need before then. Account rewards you have already received stay with your account.

docs/gitbook/troubleshooting.md

@@ -0,0 +1,49 @@
+# Troubleshooting
+
+Start with the problem closest to yours. If these steps do not help, use **Report a bug** and tell us what you see.
+
+## The picture is blank or loading forever
+
+Check your internet connection and refresh once. Try a different map. If only one map fails, mention which one in your report. In multiplayer, the timer keeps running while you refresh.
+
+## I cannot host a party
+
+Sign in first. Hosting needs an account; joining a friend's invitation does not. Your host name comes from your account's Display Name.
+
+## My friend's invite will not work
+
+Ask whether the party is full, already started, or closed. The host can create a fresh party if needed. Old unfinished parties expire after 24 hours.
+
+## My upload is taking a while
+
+Open the map from **My account** and read its progress message. Preparing a large map can take time. If it shows an error, include that message in a bug report. Repeatedly uploading the same map usually will not help.
+
+> Upload button: clicked. Me, one second later: “Are we there yet?” ⏳
+
+![Mr Bean Waiting meme: Mr Bean checks his watch and waits in a field](https://i.imgflip.com/21ajtl.jpg)
+
+The classic waiting reaction. Check the progress message before trying the upload again. [Meme source: Imgflip](https://imgflip.com/memetemplate/123104217/Mr-bean-waiting).
+
+## I cannot publish a friend's ZIP map
+
+That is expected. You can play the imported copy privately and invite friends. Only the original owner can submit the original map for public review.
+
+## My contribution disappeared
+
+Contributions leave the dashboard list after five days, but they are not deleted. Use the direct link if you kept it, or ask the map owner for help.
+
+## The capture says I am on the wrong server
+
+Check that you joined the server the map owner told you to use. If it still fails, ask them to check the expected server address.
+
+## I cannot open an old guest bug report
+
+Try the browser you originally used. Guest reports depend on that browser remembering you. For future reports, sign in or choose Keep this report in my account. Closed reports are deleted after three days.
+
+## The Windows app will not load
+
+Check your connection, then try [MineGeo in your browser](https://minegeo.vercel.app). Tell support whether the website works and the app does not, or both fail.
+
+## Discord still shows a closed party
+
+The message turns red and should disappear five minutes after the closed notice reaches Discord. If delivery is delayed, the invite's lobby page shows whether the party is actually open.