GPS Systems by MrDino

What Is GPS Systems?

GPS Systems is a route-based navigation plugin for city, roleplay, survival and network servers.
Instead of drawing impossible straight lines through buildings, the plugin uses an admin-built road network made of intersections and links.

Players can:

• Open a GPS map.
• Boot the GPS interface.
• Select public or private destinations.
• Follow active routes on the map and in the world.
• Save personal locations from the GPS map.
• See destination markers and local dotted final segments.

Admins can:

• Create intersections and road links in game.
• Configure one-way, two-way and blocked roads.
• Create public destinations.
• Edit destination icons from the admin destination menu.
• Teleport directly to destinations for testing.
• Reload config/language/network files.

Core Features

Live GPS Map

• Filled-map based interface.
• Startup/boot screen.
• Destination picker.
• Blue active route lines.
• Grey completed route sections.
• Destination markers.
• Readable map controls.

Road Network Routing

• Create intersections/nodes.
• Connect them as roads.
• Route through the actual road graph.
• Avoids impossible direct lines when the road requires a detour.
• Supports local dotted final segments for nearby/off-road destinations.

Dynamic Recalculation

• Recalculates when the player leaves the route.
• Detects lane changes.
• Detects wrong direction when configured.
• Keeps the current route stable unless the player actually deviates.

Destination Categories

• Category colors.
• Map symbols.
• Pixel-style map icon patterns.
• Default categories for police, hospital, fire station, shops, food, banks and more.
• Custom category styles in destinations.yml.

Admin Tools

• All tools use clear names: GPS <Name> Tool.
• Visual direction indicators.
• In-game road editing.
• Undo support.
• Destination icon editing from the GUI.

Included Tools

GPS Destination Tool
Create public destinations in game.


GPS Network Tool
Inspect the road network with visual overlays.


GPS Intersection Tool
Create and link intersections.


GPS Remover Tool
Remove links or intersections.


GPS Undo Tool
Undo recent network edits.


GPS Destination Link Tool
Links destinations with a custom walking path to the main route.


GPS Toolset Tool
Admin menu item that gives the full toolset.



Admin Setup Flow

1. Run /gps admin.
2. Get the GPS tools.
3. Use GPS Intersection Tool to create intersections.
   
4. Use GPS Traffic Tool to set one-way or blocked links when needed.
   Making ONE WAY roads: Right Click one node, Left Click the next node.
   
   
   Making BOTH WAY roads: Right Click the starting node, Shift Left Click the next node.
   
   
   
5. Create destinations with GPS Destination Tool or /gps set.
   
   
6. Link Destinations with the Main Route
   
7. Test routes with /gps start <destination> or the GPS map.

Player Experience

1. Player receives a GPS map.
2. Player right-clicks to boot the GPS.
3. Player opens destinations.
4. Player selects a route.
5. GPS displays the route on the map.
6. Particles and HUD guide the player.
7. Completed road sections turn grey.
8. The destination marker remains visible.

Commands

/gps
Permission: gpssystems.use
Opens the GPS menu.

/gps menu
Permission: gpssystems.use
Opens the GPS menu.

/gps start {destination}
Permission: gpssystems.use
Starts navigation to a destination.

/gps stop
Permission: gpssystems.use
Stops current navigation.

/gps list
Permission: gpssystems.use
Lists available destinations.

/gps admin
Permission: gpssystems.admin
Opens the admin menu.

/gps reload
Permission: gpssystems.admin
Reloads config, languages, destinations and network data.

/gps set {id} {display name}
Permission: gpssystems.admin
Creates a destination at your current location.

/gps point {id} {display name}
Permission: gpssystems.admin
Creates a route point/intersection at your current location.

/gps connect {pointA} {pointB}
Permission: gpssystems.admin
Connects two route points.

/gps link {destination} {point}
Permission: gpssystems.admin
Links a public destination to a route point.

/gps builder
Permission: gpssystems.admin
Toggles route builder mode.

/gps editor
Permission: gpssystems.admin
Toggles network editor overlay.

/gps tool
Permission: gpssystems.admin
Gives admin GPS tools.

/gps map
Permission: gpssystems.admin
Gives a GPS map.

/gps tp {destination}
Permission: gpssystems.admin
Teleports to a destination.

/gpstp {destination}
Permission: gpssystems.admin
Teleports to a GPS destination without overriding vanilla /tp.

Permissions

gpssystems.use
Default: true
Allows players to use GPS menus and navigation.

gpssystems.admin
Default: op
Allows admin tools, editing, reload and teleport commands.


Configuration

config.yml

• Language selection.
• Map zoom.
• Automatic GPS map on first join.
• Route follow corridor.
• Lane matching.
• Wrong-direction matching.
• Dynamic recalculation.
• Particle, boss bar, action bar and audio settings.

destinations.yml

• Public destinations.
• Private player destinations.
• Destination icons.
• Destination permissions.
• Destination categories.
• Category colors, symbols and map icon patterns.

network.yml

• Intersections/route points.
• Road links.
• Street groups.
• Traffic rules.
• Destination-to-network links.

Traffic rule types:

• both = normal two-way road.
• oneway = only from "from" to "to".
• reverse = only from "to" to "from".
• blocked = GPS cannot use this road.

Destination Icon Editing


Admins can edit public destination icons directly from the Public Destinations menu.

• Left click starts navigation.
• Right click renames the destination.
• Shift-click sets the icon using the item in the cursor or main hand.

The selected icon is saved in destinations.yml as the Bukkit material name.


Why Use GPS Systems?

• No client mods required.
• Works with normal map items.
• Designed for real roads, not just straight-line compasses.
• Admin-friendly in-game editing tools.
• Detailed YAML configuration with comments.
• Good for roleplay cities, survival hubs, transport networks and large public servers.

Support Notes
If a route looks wrong:

• Check the destination is linked to a valid network point.
• Check one-way rules are not reversed.
• Check nearby parallel lanes are represented correctly.
• Increase or decrease lane matching radius depending on road width.
• Use the in-game editor overlay to inspect intersections and links.

For full guide go to: https://mrdino.es/gps/