Traverse

Let supporters choose where home is, without handing out a coordinate list.

Traverse is a supporter perk platform for Minecraft servers. A qualifying player runs one command in game, follows a one-time link into the web app, says what kind of landscape they want to live in, and gets a small set of hand-checked candidate locations to compare. Exact coordinates stay hidden until they spend their single reveal.

It is two pieces that ship together:

• a web app (Fastify API, React supporter wizard, React admin console) that owns the world config, the biome search, and every claim, and
• a Paper plugin that recognises qualifying supporters, issues them a one-time access link, and surfaces an onboarding dialog on join.

How it works

1. A supporter joins the server. The plugin asks the API whether they qualify, using either a LuckPerms permission node or a LuckPerms group, and an entitlement is created if they do.
2. On their first join after qualifying they get an onboarding dialog; at any time they can run /traverse to get a fresh link. The link is single-use and lives for 15 minutes.
3. In the web app they pick a primary biome or biome category, optionally a secondary one, and a plot radius between 50 and 100 blocks.
4. The server runs a biome search against the real world seed and returns a few candidates that clear the world's coverage thresholds, avoid spawn, exclusion zones, the world border, and every claim already taken.
5. The supporter compares candidates on a blurred preview map, then spends their one reveal. That writes the claim, locks the area against other supporters, and shows exact coordinates.
6. Staff see every claim on a world map in the admin console, and can release, supersede, or revoke one.

Key features

• Biome-first search - supporters choose a landscape, not a coordinate. Primary plus optional secondary selector, by individual biome or by admin-defined category.
• Real seed accuracy - biomes are generated from the world's actual seed by a native Cubiomes engine, so what the preview shows is what is on the server.
• One reveal - coordinates are hidden behind a deliberate, single, irreversible choice. Preview maps are rendered server side so the location cannot be scraped from the client.
• Automatic claim spacing - a new candidate is never offered inside another supporter's claim, inside an exclusion zone, near spawn, or outside the border.
• Admin exclusion zones - draw circles and rectangles on the world map to keep builds, roads, and future projects out of the search.
• LuckPerms qualification - qualify by permission node or by group, per world. Operators bypass the check so staff can test.
• Windowed campaigns - each world has a start and an end, and derives a state of SCHEDULED, ACTIVE, ENDED, or DISABLED.
• Support requests - supporters who lose a link or need help file a request from inside the app, optionally relayed to a Discord webhook.
• Audit log - every admin change records who, what, before, after, and the source IP.

Where to go next

• A supporter with a link? The Supporter Guide walks through the whole flow.
• Setting up the plugin? Start with Plugin Setup.
• Hosting the web app? See Installation, then Configuration.
• Running a campaign? The Admin Guide covers worlds, claims, exclusion zones, and support requests.
• Wondering why a search returned nothing? How Matching Works explains every filter.
• Integrating with the API? See the Plugin API Reference.
• Something went wrong? Troubleshooting & FAQ.