Cobblestone¶

Server-side navigation for Minecraft.

Players

Save locations and navigate to them.
Server admins

Installation, commands, permissions, and configuration.
Developers

Register destinations, modify searches, and start trips.

Overview¶

Cobblestone runs an A* search over the live world and renders the resulting route as a particle trail. Routes account for walking, swimming, climbing, falling, boats, horses, doors, and portals. If the player leaves the route, it is recomputed.

Cobblestone does not teleport players itself. Integrations can register teleport commands, such as EssentialsX /home or Towny /town spawn, as route steps that the player is prompted to run.

/stone location set home        # save the current position
/nav home                       # navigate back to it

Architecture¶

flowchart LR
    A["/navigate &lt;destination&gt;"] --> B[Destination providers]
    B --> C[A* search]
    D[Search modifications] --> C
    C --> E[Path]
    E --> F[Trip]
    F --> G[Navigator]
    G -. player strays .-> C

Destination providers, search modifications, and navigators are all extensible. See the developer documentation.

Supported versions¶

Platform	Minecraft	Java
Paper	26.1+	25+
Sponge	1.21.1	21+
Sponge	26.1+	25+

Performance¶

Searches run asynchronously and are bounded per player. The configuration file exposes options to increase or reduce the resources each search may use.

Metrics¶

Cobblestone reports anonymous, aggregate usage data to bStats. Disable it with metrics.enabled: false.