Move the field guide into the docs section
Some checks failed
Deploy MineGeo to Dokploy / deploy (push) Failing after 10m22s

This commit is contained in:
2026-10-28 11:08:36 +05:00
parent ed4d264801
commit 5898ef35a5
14 changed files with 85 additions and 103 deletions

View File

@@ -1,52 +1,5 @@
import { getI18n } from "@/lib/i18n"; import { permanentRedirect } from "next/navigation";
import { Header, Footer } from "@/components/Shell";
import Link from "next/link"; export default function About() {
export default async function About() { permanentRedirect("/docs?page=guide");
const { t } = await getI18n();
return (
<>
<Header />
<main className="section page-content prose" id="main-content" tabIndex={-1}>
<span className="eyebrow">{t("THE EXPLORER’S FIELD GUIDE")}</span>
<h1>
{t("You know this place.")}
<br />
<span className="green">{t("Probably.")}</span>
</h1>
<p className="lead">
{t(
"MineGeo drops you into a panorama from a community Minecraft world. Find out where you are before the clock runs out.",
)}
</p>
<h2>{t("Look for the little things")}</h2>
<p>
{t(
"Drag to look around. Mountains, shorelines, roofs, and landmarks all help. You stay in one place throughout a round.",
)}
</p>
<h2>{t("Make your guess")}</h2>
<p>
{t(
"Expand the map in the bottom-right corner and click to place a pin. North is up, X increases east, and Z increases south. Move your pin until you’re ready, then submit.",
)}
</p>
<h2>{t("Five chances to find your way")}</h2>
<p>
{t(
"Easy gives you 180 seconds, Normal 90, and Hard 30. Void is the hardest: just 10 seconds, a fixed panorama and map, no zoom, no compass or coordinates, and strict scoring. A timed-out round scores zero; you can still finish the expedition.",
)}
</p>
<h2>{t("Closer means better")}</h2>
<p>
{t(
"Each round awards up to 5,000 points based on horizontal distance. A guess within one block earns a perfect score. Compare all five guesses at the end.",
)}
</p>
<Link href="/servers" className="button primary">
{t("Let’s find a world →")}
</Link>
</main>
<Footer />
</>
);
} }

View File

@@ -5,6 +5,7 @@ import { Header, Footer } from "@/components/Shell";
import guides from "@/shared/player-docs.json"; import guides from "@/shared/player-docs.json";
import styles from "./page.module.css"; import styles from "./page.module.css";
import { getI18n } from "@/lib/i18n"; import { getI18n } from "@/lib/i18n";
import { PlayerGuide } from "@/components/PlayerGuide";
export const metadata = { title: "Player docs" }; export const metadata = { title: "Player docs" };
@@ -80,7 +81,13 @@ export default async function Docs({
const { page = "welcome" } = await searchParams; const { page = "welcome" } = await searchParams;
const { locale } = await getI18n(); const { locale } = await getI18n();
const pages = [ const pages = [
...guides, guides[0],
{
slug: "guide",
title: locale === "ru" ? "Руководство" : "Field guide",
markdown: "",
},
...guides.slice(1),
{ {
slug: "developer-api", slug: "developer-api",
title: locale === "ru" ? "API для разработчиков" : "Developer API", title: locale === "ru" ? "API для разработчиков" : "Developer API",
@@ -93,7 +100,11 @@ export default async function Docs({
return ( return (
<> <>
<Header /> <Header />
<main className={`section page-content ${styles.layout}`} id="main-content" tabIndex={-1}> <main
className={`section page-content ${styles.layout}`}
id="main-content"
tabIndex={-1}
>
<aside> <aside>
<h2>Player docs</h2> <h2>Player docs</h2>
<nav aria-label="Documentation pages" className={styles.menu}> <nav aria-label="Documentation pages" className={styles.menu}>
@@ -109,7 +120,9 @@ export default async function Docs({
</nav> </nav>
</aside> </aside>
<article className={`prose ${styles.article}`}> <article className={`prose ${styles.article}`}>
{page === "developer-api" ? ( {page === "guide" ? (
<PlayerGuide />
) : page === "developer-api" ? (
<DeveloperDocumentation locale={locale} /> <DeveloperDocumentation locale={locale} />
) : ( ) : (
content(guide.markdown) content(guide.markdown)

View File

@@ -229,7 +229,7 @@ export default async function Home() {
</div> </div>
</li> </li>
</ol> </ol>
<Link className="text-link" href="/about"> <Link className="text-link" href="/docs?page=guide">
{t("Read the field guide")} <ArrowRight size={14} /> {t("Read the field guide")} <ArrowRight size={14} />
</Link> </Link>
</article> </article>

View File

@@ -1,36 +1,24 @@
"use client"; "use client";
import { useEffect, useRef } from "react"; import { useLayoutEffect, useRef } from "react";
import { usePathname, useSearchParams } from "next/navigation"; import { usePathname, useSearchParams } from "next/navigation";
/** Animate the new content after browser history navigation, without delaying it. */ /** Animate newly committed pages without delaying navigation. */
export function BackNavigationTransition() { export function BackNavigationTransition() {
const pathname = usePathname(); const pathname = usePathname();
const search = useSearchParams(); const search = useSearchParams();
const route = `${pathname}?${search.toString()}`; // Documentation pages share a pathname; other query changes are filters or
const historyNavigation = useRef(false); // state updates and should not animate the entire page.
const route =
pathname === "/docs"
? `${pathname}?page=${search.get("page") ?? "welcome"}`
: pathname;
const previousPath = useRef(route); const previousPath = useRef(route);
useEffect(() => { useLayoutEffect(() => {
const onPopState = () => {
historyNavigation.current =
`${window.location.pathname}?${new URLSearchParams(window.location.search).toString()}` !==
previousPath.current;
};
window.addEventListener("popstate", onPopState);
return () => window.removeEventListener("popstate", onPopState);
}, []);
useEffect(() => {
if (previousPath.current === route) return; if (previousPath.current === route) return;
previousPath.current = route; previousPath.current = route;
const fromHistory = historyNavigation.current; if (window.matchMedia("(prefers-reduced-motion: reduce)").matches) return;
historyNavigation.current = false;
if (
!fromHistory ||
window.matchMedia("(prefers-reduced-motion: reduce)").matches
)
return;
const main = document.getElementById("main-content"); const main = document.getElementById("main-content");
if (!main || typeof main.animate !== "function") return; if (!main || typeof main.animate !== "function") return;
const animation = main.animate( const animation = main.animate(

View File

@@ -0,0 +1,47 @@
import { getI18n } from "@/lib/i18n";
import Link from "next/link";
export async function PlayerGuide() {
const { t } = await getI18n();
return (
<>
<span className="eyebrow">{t("THE EXPLORER’S FIELD GUIDE")}</span>
<h1>
{t("You know this place.")}
<br />
<span className="green">{t("Probably.")}</span>
</h1>
<p className="lead">
{t(
"MineGeo drops you into a panorama from a community Minecraft world. Find out where you are before the clock runs out.",
)}
</p>
<h2>{t("Look for the little things")}</h2>
<p>
{t(
"Drag to look around. Mountains, shorelines, roofs, and landmarks all help. You stay in one place throughout a round.",
)}
</p>
<h2>{t("Make your guess")}</h2>
<p>
{t(
"Expand the map in the bottom-right corner and click to place a pin. North is up, X increases east, and Z increases south. Move your pin until you’re ready, then submit.",
)}
</p>
<h2>{t("Five chances to find your way")}</h2>
<p>
{t(
"Easy gives you 180 seconds, Normal 90, and Hard 30. Void is the hardest: just 10 seconds, a fixed panorama and map, no zoom, no compass or coordinates, and strict scoring. A timed-out round scores zero; you can still finish the expedition.",
)}
</p>
<h2>{t("Closer means better")}</h2>
<p>
{t(
"Each round awards up to 5,000 points based on horizontal distance. A guess within one block earns a perfect score. Compare all five guesses at the end.",
)}
</p>
<Link href="/servers" className="button primary">
{t("Let’s find a world →")}
</Link>
</>
);
}

View File

@@ -12,7 +12,6 @@ const links = [
["/tournaments", "Tournaments"], ["/tournaments", "Tournaments"],
["/changelogs", "Changelogs"], ["/changelogs", "Changelogs"],
["/downloads", "Downloads"], ["/downloads", "Downloads"],
["/about", "Guide"],
["/docs", "Docs"], ["/docs", "Docs"],
] as const; ] as const;

View File

@@ -2,8 +2,6 @@
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. 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? ## Just want to play?
1. Open [Play & maps](https://minegeo.site/servers). 1. Open [Play & maps](https://minegeo.site/servers).

View File

@@ -23,8 +23,6 @@ After uploading, open **My account**, find your map, and click **Open map**. Wai
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. 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 ## 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. 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.

View File

@@ -31,8 +31,6 @@ You **cannot publish it, submit it for review, re-export it, or announce its par
You do not need a moderator's approval to import or play the file. 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 ## 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. 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.

View File

@@ -22,8 +22,6 @@ Open **Chat** in the lobby, during a round, or on the results screen. Type a mes
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. 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? ## 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. 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.

View File

@@ -17,8 +17,6 @@ Your goal is to work out where the view was taken. You do not need to know Minec
- **Normal:** 90 seconds per round, with zoom. - **Normal:** 90 seconds per round, with zoom.
- **Hard:** 30 seconds per round, without zoom. Bring your detective hat. - **Hard:** 30 seconds per round, without zoom. Bring your detective hat.
> “Just one more look around.” The timer: 0:01. 💀
## How points work ## 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. 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.

View File

@@ -26,5 +26,3 @@ If you have an active glow, open **Settings → Username glow**, choose a color,
## Be a good party member ## 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. 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. ⛰️

View File

@@ -18,12 +18,6 @@ Ask whether the party is full, already started, or closed. The host can create a
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. 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 ## 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. 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.

View File

@@ -2,17 +2,17 @@
{ {
"title": "Welcome to MineGeo", "title": "Welcome to MineGeo",
"slug": "welcome", "slug": "welcome",
"markdown": "# Welcome to MineGeo\n\nWelcome, 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.\n\n> Me: “I know this place.” Also me: guesses on the other side of the map. 🗿\n\n## Just want to play?\n\n1. Open [Play & maps](https://minegeo.site/servers).\n2. Choose a map.\n3. Choose Easy for a relaxed first game.\n4. Click **Start exploring**.\n\nYou 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.\n\n## Find your guide\n\n- **Multiplayer and chat:** invite friends and talk while you play.\n- **Accounts and appearance:** change your name, theme, or glow color.\n- **Windows desktop client:** play in a separate app.\n- **Create and publish a map:** let others explore your Minecraft builds.\n- **Share and import maps:** play a map your friend sent as a ZIP file.\n- **Bug reports and support:** get help when something breaks.\n\n## A small heads-up\n\nYou 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.\n\nMineGeo is an independent community project, not affiliated with Mojang or Microsoft." "markdown": "# Welcome to MineGeo\n\nWelcome, 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.\n\n## Just want to play?\n\n1. Open [Play & maps](https://minegeo.site/servers).\n2. Choose a map.\n3. Choose Easy for a relaxed first game.\n4. Click **Start exploring**.\n\nYou 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.\n\n## Find your guide\n\n- **Multiplayer and chat:** invite friends and talk while you play.\n- **Accounts and appearance:** change your name, theme, or glow color.\n- **Windows desktop client:** play in a separate app.\n- **Create and publish a map:** let others explore your Minecraft builds.\n- **Share and import maps:** play a map your friend sent as a ZIP file.\n- **Bug reports and support:** get help when something breaks.\n\n## A small heads-up\n\nYou 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.\n\nMineGeo is an independent community project, not affiliated with Mojang or Microsoft."
}, },
{ {
"title": "Your first game", "title": "Your first game",
"slug": "playing", "slug": "playing",
"markdown": "# Your first game\n\nYour goal is to work out where the view was taken. You do not need to know Minecraft coordinates to enjoy a game.\n\n## Play a round\n\n1. Open [Play & maps](https://minegeo.site/servers), choose a map, and keep **Solo** selected.\n2. Pick a difficulty and click **Start exploring**.\n3. Drag the picture to look around. You can turn your view, but you cannot walk around.\n4. Look for a mountain, beach, river, road, or interesting building.\n5. Open the small map in the bottom-right corner. Click where you think you are to place a pin.\n6. Move the pin if you change your mind, then submit your guess before time runs out.\n\n## Pick your pace\n\n- **Easy:** 3 minutes per round, with zoom. A good place to start.\n- **Normal:** 90 seconds per round, with zoom.\n- **Hard:** 30 seconds per round, without zoom. Bring your detective hat.\n\n> “Just one more look around.” The timer: 0:01. 💀\n\n## How points work\n\nA 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.\n\nNorth 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.\n\n![Confused Math Lady meme: a puzzled face surrounded by equations](https://i.imgflip.com/6677gf.png)\n\nA familiar reaction when every mountain looks like your mountain. [Meme source: Imgflip](https://imgflip.com/memetemplate/373211007/Confusion).\n\n## See how you did\n\nAt the end, compare your guesses with the real locations. Visit the [Leaderboard](https://minegeo.site/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." "markdown": "# Your first game\n\nYour goal is to work out where the view was taken. You do not need to know Minecraft coordinates to enjoy a game.\n\n## Play a round\n\n1. Open [Play & maps](https://minegeo.site/servers), choose a map, and keep **Solo** selected.\n2. Pick a difficulty and click **Start exploring**.\n3. Drag the picture to look around. You can turn your view, but you cannot walk around.\n4. Look for a mountain, beach, river, road, or interesting building.\n5. Open the small map in the bottom-right corner. Click where you think you are to place a pin.\n6. Move the pin if you change your mind, then submit your guess before time runs out.\n\n## Pick your pace\n\n- **Easy:** 3 minutes per round, with zoom. A good place to start.\n- **Normal:** 90 seconds per round, with zoom.\n- **Hard:** 30 seconds per round, without zoom. Bring your detective hat.\n\n## How points work\n\nA 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.\n\nNorth 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.\n\n![Confused Math Lady meme: a puzzled face surrounded by equations](https://i.imgflip.com/6677gf.png)\n\nA familiar reaction when every mountain looks like your mountain. [Meme source: Imgflip](https://imgflip.com/memetemplate/373211007/Confusion).\n\n## See how you did\n\nAt the end, compare your guesses with the real locations. Visit the [Leaderboard](https://minegeo.site/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."
}, },
{ {
"title": "Multiplayer and chat", "title": "Multiplayer and chat",
"slug": "multiplayer", "slug": "multiplayer",
"markdown": "# Multiplayer and chat\n\nLost together is better than lost alone. Invite friends, play the same five locations, and compare your scores.\n\n## Start a party\n\n1. Sign in to MineGeo.\n2. Open a map and choose **Multiplayer**.\n3. Choose the difficulty and how many players can join, from **2 to 16**, including you.\n4. Create the party, copy the invite link, and send it to your friends.\n5. Start when at least two players have joined.\n\nThe 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.\n\n## Join a friend\n\nOpen 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.\n\n## Talk while playing\n\nOpen **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.\n\nMessages 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.\n\n> Friend: “Trust me, it's by the lake.” The map: three lakes. 🤔\n\n## What happens between rounds?\n\nEveryone 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.\n\nRefreshing 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.\n\n## Invite the Discord community\n\nOn 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.\n\nPrivate 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.\n\n## If the host leaves\n\nAnother 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." "markdown": "# Multiplayer and chat\n\nLost together is better than lost alone. Invite friends, play the same five locations, and compare your scores.\n\n## Start a party\n\n1. Sign in to MineGeo.\n2. Open a map and choose **Multiplayer**.\n3. Choose the difficulty and how many players can join, from **2 to 16**, including you.\n4. Create the party, copy the invite link, and send it to your friends.\n5. Start when at least two players have joined.\n\nThe 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.\n\n## Join a friend\n\nOpen 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.\n\n## Talk while playing\n\nOpen **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.\n\nMessages 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.\n\n## What happens between rounds?\n\nEveryone 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.\n\nRefreshing 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.\n\n## Invite the Discord community\n\nOn 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.\n\nPrivate 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.\n\n## If the host leaves\n\nAnother 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."
}, },
{ {
"title": "Accounts and appearance", "title": "Accounts and appearance",
@@ -27,7 +27,7 @@
{ {
"title": "Create and publish a map", "title": "Create and publish a map",
"slug": "creating-maps", "slug": "creating-maps",
"markdown": "# Create and publish a map\n\nBuilt something worth getting lost in? Turn it into a map for other players.\n\n## The short version\n\n1. Capture views in Minecraft with a MineGeo capture tool.\n2. Upload them to your account.\n3. Check your private map and choose the views you want to use.\n4. Send it for review when it is ready.\n\nUploading does not immediately make your map public. A **draft** is a map only you can work on before sharing it publicly.\n\n## How do I take the pictures?\n\nUse the MineGeo capture mod from [Downloads](https://minegeo.site/downloads). A mod is an add-on for Minecraft. It helps you capture views and send them to MineGeo.\n\nOpen **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.\n\n## Check your map\n\nAfter uploading, open **My account**, find your map, and click **Open map**. Wait for the pictures to finish preparing.\n\nGive 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.\n\n> Your beautiful base: 10/10. Your ability to recognize its back wall: 0/10. 😅\n\n## Let everyone play\n\nClick **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.\n\nWhile a public map's update is being checked, players can still enjoy its previous approved version. Some editing controls are unavailable during review.\n\nA map imported from a friend's ZIP cannot be submitted as your own. You can play that copy privately instead." "markdown": "# Create and publish a map\n\nBuilt something worth getting lost in? Turn it into a map for other players.\n\n## The short version\n\n1. Capture views in Minecraft with a MineGeo capture tool.\n2. Upload them to your account.\n3. Check your private map and choose the views you want to use.\n4. Send it for review when it is ready.\n\nUploading does not immediately make your map public. A **draft** is a map only you can work on before sharing it publicly.\n\n## How do I take the pictures?\n\nUse the MineGeo capture mod from [Downloads](https://minegeo.site/downloads). A mod is an add-on for Minecraft. It helps you capture views and send them to MineGeo.\n\nOpen **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.\n\n## Check your map\n\nAfter uploading, open **My account**, find your map, and click **Open map**. Wait for the pictures to finish preparing.\n\nGive 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.\n\n## Let everyone play\n\nClick **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.\n\nWhile a public map's update is being checked, players can still enjoy its previous approved version. Some editing controls are unavailable during review.\n\nA map imported from a friend's ZIP cannot be submitted as your own. You can play that copy privately instead."
}, },
{ {
"title": "Capture your Minecraft world", "title": "Capture your Minecraft world",
@@ -42,7 +42,7 @@
{ {
"title": "Share and import maps", "title": "Share and import maps",
"slug": "map-sharing", "slug": "map-sharing",
"markdown": "# Share and import maps\n\nYour 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.\n\n## Send your own map\n\n1. Sign in as the map's original owner.\n2. Save your changes.\n3. Click **Export ZIP** in your map editor or on its public page.\n4. Send the downloaded file to your friend, for example through a service that accepts files of that size.\n\nOnly 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.\n\n## Play a map your friend sent\n\n1. Download their ZIP to your computer.\n2. Sign in to MineGeo.\n3. Open **Play & maps** and click **Import** beside the search box. You can also find Import in **My account**.\n4. Choose the downloaded ZIP. It must be no larger than **256 MB**.\n5. Wait for MineGeo to prepare it, then open it from your account.\n\nYou do not need Minecraft installed. Keep the ZIP as your friend sent it; MineGeo handles opening it.\n\n## What can I do with an imported map?\n\n- Play it privately by yourself.\n- Host a private multiplayer party and invite friends.\n- See the original creator's name next to **Owned by**.\n\nYou **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.\n\nYou do not need a moderator's approval to import or play the file.\n\n> Friend: “I made an easy map.” The first view: identical trees in every direction. 🌳\n\n## The file will not import\n\nCheck 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." "markdown": "# Share and import maps\n\nYour 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.\n\n## Send your own map\n\n1. Sign in as the map's original owner.\n2. Save your changes.\n3. Click **Export ZIP** in your map editor or on its public page.\n4. Send the downloaded file to your friend, for example through a service that accepts files of that size.\n\nOnly 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.\n\n## Play a map your friend sent\n\n1. Download their ZIP to your computer.\n2. Sign in to MineGeo.\n3. Open **Play & maps** and click **Import** beside the search box. You can also find Import in **My account**.\n4. Choose the downloaded ZIP. It must be no larger than **256 MB**.\n5. Wait for MineGeo to prepare it, then open it from your account.\n\nYou do not need Minecraft installed. Keep the ZIP as your friend sent it; MineGeo handles opening it.\n\n## What can I do with an imported map?\n\n- Play it privately by yourself.\n- Host a private multiplayer party and invite friends.\n- See the original creator's name next to **Owned by**.\n\nYou **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.\n\nYou do not need a moderator's approval to import or play the file.\n\n## The file will not import\n\nCheck 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."
}, },
{ {
"title": "Bug reports and support", "title": "Bug reports and support",
@@ -57,12 +57,12 @@
{ {
"title": "Troubleshooting", "title": "Troubleshooting",
"slug": "troubleshooting", "slug": "troubleshooting",
"markdown": "# Troubleshooting\n\nStart with the problem closest to yours. If these steps do not help, use **Report a bug** and tell us what you see.\n\n## The picture is blank or loading forever\n\nCheck 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.\n\n## I cannot host a party\n\nSign in first. Hosting needs an account; joining a friend's invitation does not. Your host name comes from your account's Display Name.\n\n## My friend's invite will not work\n\nAsk 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.\n\n## My upload is taking a while\n\nOpen 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.\n\n> Upload button: clicked. Me, one second later: “Are we there yet?” ⏳\n\n![Mr Bean Waiting meme: Mr Bean checks his watch and waits in a field](https://i.imgflip.com/21ajtl.jpg)\n\nThe classic waiting reaction. Check the progress message before trying the upload again. [Meme source: Imgflip](https://imgflip.com/memetemplate/123104217/Mr-bean-waiting).\n\n## I cannot publish a friend's ZIP map\n\nThat is expected. You can play the imported copy privately and invite friends. Only the original owner can submit the original map for public review.\n\n## My contribution disappeared\n\nContributions 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.\n\n## The capture says I am on the wrong server\n\nCheck that you joined the server the map owner told you to use. If it still fails, ask them to check the expected server address.\n\n## I cannot open an old guest bug report\n\nTry 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.\n\n## The Windows app will not load\n\nCheck your connection, then try [MineGeo in your browser](https://minegeo.site). Tell support whether the website works and the app does not, or both fail.\n\n## Discord still shows a closed party\n\nThe 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." "markdown": "# Troubleshooting\n\nStart with the problem closest to yours. If these steps do not help, use **Report a bug** and tell us what you see.\n\n## The picture is blank or loading forever\n\nCheck 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.\n\n## I cannot host a party\n\nSign in first. Hosting needs an account; joining a friend's invitation does not. Your host name comes from your account's Display Name.\n\n## My friend's invite will not work\n\nAsk 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.\n\n## My upload is taking a while\n\nOpen 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.\n\n## I cannot publish a friend's ZIP map\n\nThat is expected. You can play the imported copy privately and invite friends. Only the original owner can submit the original map for public review.\n\n## My contribution disappeared\n\nContributions 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.\n\n## The capture says I am on the wrong server\n\nCheck that you joined the server the map owner told you to use. If it still fails, ask them to check the expected server address.\n\n## I cannot open an old guest bug report\n\nTry 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.\n\n## The Windows app will not load\n\nCheck your connection, then try [MineGeo in your browser](https://minegeo.site). Tell support whether the website works and the app does not, or both fail.\n\n## Discord still shows a closed party\n\nThe 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."
}, },
{ {
"title": "Community and badges", "title": "Community and badges",
"slug": "staff", "slug": "staff",
"markdown": "# Community and badges\n\nMeet other explorers, recognize the people helping the community, and make your account feel like yours.\n\n## Join Discord\n\nUse the Discord button at the bottom of MineGeo, or [join the community here](https://discord.gg/Aer4ZugKWS).\n\nNewly 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.\n\n## What do the name badges mean?\n\n- **Moderator, with a shield:** someone who can check maps and approve them for public play.\n- **Admin, with a crown:** someone who can also handle community reports and other site management.\n- **Bug finder:** someone recognized for helping find a confirmed bug.\n- **Custom prefix:** extra text and an icon assigned by an Admin.\n\nA decorative custom prefix does not give someone moderation powers. Copying another player's name does not copy their badges.\n\n## Can I get a glow?\n\nSupport 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.\n\nIf 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.\n\n## Be a good party member\n\nShare invites thoughtfully, keep chat friendly, and avoid spoiling the location before everyone has guessed. Report content that needs attention instead of starting an argument.\n\n> The real treasure was the friends who also guessed the wrong mountain. ⛰️" "markdown": "# Community and badges\n\nMeet other explorers, recognize the people helping the community, and make your account feel like yours.\n\n## Join Discord\n\nUse the Discord button at the bottom of MineGeo, or [join the community here](https://discord.gg/Aer4ZugKWS).\n\nNewly 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.\n\n## What do the name badges mean?\n\n- **Moderator, with a shield:** someone who can check maps and approve them for public play.\n- **Admin, with a crown:** someone who can also handle community reports and other site management.\n- **Bug finder:** someone recognized for helping find a confirmed bug.\n- **Custom prefix:** extra text and an icon assigned by an Admin.\n\nA decorative custom prefix does not give someone moderation powers. Copying another player's name does not copy their badges.\n\n## Can I get a glow?\n\nSupport 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.\n\nIf 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.\n\n## Be a good party member\n\nShare invites thoughtfully, keep chat friendly, and avoid spoiling the location before everyone has guessed. Report content that needs attention instead of starting an argument.\n\n"
}, },
{ {
"slug": "account-bans", "slug": "account-bans",