⌨️ Commands

The complete manual for every /routes command — the road network.

👤 = every player · 🛡️ = operator (permission level 2)

Quick reference

Command	Who	One-liner
/routes status	👤	Network summary: towns, nodes, completed routes, queued edges.
/routes list [cities\|routes]	👤	Every known town / completed route, with coordinates.
/routes nearest	👤	Closest town and route, with distance and heading.
/routes zone	👤	What the chunk you stand in is painted as.
/routes scan [radius]	🛡️	Scan loaded chunks for city structures (1–100 chunks).
/routes connect	🛡️	Queue a road between the two nearest cities.
/routes structures	🛡️	Dump the structure-registry match report.
/routes addcity [name]	🛡️	Register where you stand as a named city.
/routes rename <name>	🛡️	Rename the nearest town.
/routes tp <town>	🛡️	Teleport to a named town.
/routes weave [loops]	🛡️	Force ring roads now (1–16).
/routes repaint	🛡️	Re-broadcast the map paint to everyone online.
/routes reset	🛡️	Wipe the roads and re-queue every connection.

---

🛤️ /routes — the road network

status — 👤

Prints the network at a glance: how many towns are known (and how many have real names), how many route nodes were discovered, how many routes are completed, and how many candidate edges wait in the build queue — then the first 16 routes with their endpoints.

list [cities|routes] — 👤

The full inventory. cities lists every known town — its name (or (unnamed town)) and its x, z coordinates; routes lists every completed route with its two endpoints. With no argument you get both. Long lists are capped at 24 lines with an "… and N more" trailer.

nearest — 👤

Where's civilization? Reports the closest town and the closest route to where you stand, each with the distance in blocks and a compass heading (N, NE, E, …). Great when you're lost in open wilderness.

zone — 👤

The map-paint (and capture-zone) debugger: tells you what the chunk you are standing in is painted as — a CITY (with its name), a ROUTE (name and endpoints), an enclosed AREA (its A#-Name, or unnamed until first entered), or open wilderness (unpainted until your network encloses it). Always agrees with the map colours and the zone pop-ups.

scan [radiusChunks] — 🛡️

Scans the already-loaded chunks around you (default 8, up to 100 chunks radius) and registers any city structures it finds as route nodes. Use after exploring somewhere new when you don't want to wait for the automatic discovery.

connect — 🛡️

Locates the nearest connectable cities from your position (seed-based — no chunk loading) and queues a road between them. The road then builds incrementally.

structures — 🛡️

Prints the structure-registry match report: which structure tags/ids from Cities include exist in this world and what matched. The first stop when a structure type isn't being connected.

addcity [name] — 🛡️

Registers where you are standing as a city node (default name Gym) and queues its road connections. The escape hatch for places without a structure tag — player builds, modded structures, anything.

rename <name> — 🛡️

Renames the nearest town within 160 blocks. The new name shows in arrival banners, the Escape Rope message and route endpoints; existing map waypoints refresh on rejoin.

tp <town> — 🛡️

Teleports you to a named town (tab-completion suggests every real name), landing on the same safe spot the Escape Rope uses. Wrong name? It points you at /routes list cities.

weave [loops] — 🛡️

Runs the ring-road pass right now: up to loops (default 4, max 16) direct connections are queued between towns that are close on the map but far apart by road. Every loop that completes encloses a new named AREA — this is the fastest way to grow your capture zones.

repaint — 🛡️

Re-broadcasts the chunk-paint geometry to every online player, forcing the Xaero overlays to refresh without relogging.

reset — 🛡️

⚠️ Wipes the road records and re-queues every connection from the known cities. Already-paved blocks stay in the world; the network rebuilds its bookkeeping from scratch.