# GPS Systems GPS Systems is a Spigot/Paper plugin that adds visual GPS navigation to Minecraft servers. ![MAIN BANNER](https://mrdino.es/wp-content/uploads/2026/06/GPS-MAIN-BANNER-2048x683.png) It lets players open a GPS map, choose destinations, follow active routes, save private locations and receive turn-by-turn guidance through particles, map rendering, boss bars and action bar instructions. The plugin is designed for city, roleplay, survival and network-based servers where roads, districts, public services and landmarks need guided navigation. ![NAVIGATION](https://mrdino.es/wp-content/uploads/2026/06/GPS-NAVIGATION.gif) **_PLUGIN IS ON BETA PHASE, BUGS MIGHT APPEAR !!!_** **_For full guide go to: [https://mrdino.es/gps/](https://mrdino.es/gps/)_** ## Requirements - Minecraft server: Spigot/Paper compatible with API `1.20` - Java: `17` - Permission plugin: optional, but recommended for admin/player access control ## Main Features - In-game GPS map with boot/startup screen. - Public destinations configured by admins. - Private player destinations saved from the GPS map. - Road-network routing using intersections and links. - One-way, blocked and weighted road rules. - Dynamic recalculation when players leave the route or switch lanes. - Destination categories with colors, symbols and map icon patterns. - Admin tools to build, link, remove and inspect route networks. - Admin teleport command to jump directly to a destination. - Automatic GPS map given to new players, configurable. - Multi-language resource files: `en_US`, `es_ES`, `fr_FR`, `de_DE`. ## How It Works GPS Systems uses three main data layers: 1. Destinations Public and private places players can navigate to. Public destinations are stored under `destinations` in `destinations.yml`. Private destinations are stored under `player-destinations.`. 2. Route Network ![BOTH WAYS MARKER](https://mrdino.es/wp-content/uploads/2026/06/GPS-BOTH-WAYS-TOP-e1780696586696.gif) The road graph used by the GPS. It is stored in `network.yml` as route points/intersections and connections. The GPS calculates routes across this graph instead of drawing impossible straight lines through buildings. 3. Map Rendering The filled map item renders destination menus, route lines, completed grey sections, current blue route sections, destination markers and local dotted final segments. ## Basic Player Flow ![GPS LOAD](https://mrdino.es/wp-content/uploads/2026/06/GPS-MAP-LOAD.gif) 1. Player receives or obtains a GPS map. 2. Player right-clicks the map to boot the GPS. 3. Player opens the map menu and selects `Destinations`. 4. Player selects a destination. 5. GPS starts navigation with route particles, map route preview, boss bar/action bar information and destination marker. 6. The route updates as the player moves. ![GPS MENU SELECTOR](https://mrdino.es/wp-content/uploads/2026/06/GPS-MAP-MENU.gif) ![ON JOIN](https://mrdino.es/wp-content/uploads/2026/06/GPS-BANNER-10.png) ## Admin Setup Flow 1. Use `/gps admin` to open the admin panel. 2. Get the GPS tools. 3. Create intersections with the `GPS Intersection Tool`. ![INTERSECTION TOOL](https://mrdino.es/wp-content/uploads/2026/06/GPS-CUSTOM-NODES-1.gif) 4. Link intersections to create roads. ![ONE WAY MAKING](https://mrdino.es/wp-content/uploads/2026/06/GPS-LINKING.gif) ![ONE WAY MARKERS](https://mrdino.es/wp-content/uploads/2026/06/GPS-ONE-WAY-e1780696504159.gif) ![BOTH WAYS MAKING](https://mrdino.es/wp-content/uploads/2026/06/GPS-BOTH-WAYS-6.gif) 5. Create destinations with the `GPS Destination Tool` or `/gps set`. ![DESTINATION TOOL](https://mrdino.es/wp-content/uploads/2026/06/GPS-DESTINATIONS.gif) 6. Test the route using `/gps start ` or the GPS map. ## Tools ![TOOLS BANNER](https://mrdino.es/wp-content/uploads/2026/06/GPS-BANNER-8.png) All tool display names follow the format `GPS Tool`. - `GPS Destination Tool`: marks and creates public destinations. ![DESTINATION TOOL](https://mrdino.es/wp-content/uploads/2026/06/GPS-Tools-Destination-Tool.png) - `GPS Network Tool`: visual network/editor overlay tool. ![NETWORK TOOL](https://mrdino.es/wp-content/uploads/2026/06/GPS-Tools-Network-Tool.png) - `GPS Intersection Tool`: creates and links intersections. ![INTERSECTION TOOL](https://mrdino.es/wp-content/uploads/2026/06/GPS-Tools-Intersection-Tool-1.png) - `GPS Remover Tool`: removes links or intersections. ![UNLINK TOOL](https://mrdino.es/wp-content/uploads/2026/06/GPS-Tools-Remover-Tool.png) - `GPS Undo Tool`: reverts recent route-network changes. ![UNDO TOOL](https://mrdino.es/wp-content/uploads/2026/06/GPS-Tools-Undo-Tool.png) - `GPS Toolset Tool`: admin menu item that gives the full tool set. ![ALL TOOLSET TOOL](https://mrdino.es/wp-content/uploads/2026/06/GPS-Tools-All-Tools.png) ## Commands | Command | Permission | Description | | --- | --- | --- | | `/gps` | `gpssystems.use` | Opens the GPS menu. | | `/gps menu` | `gpssystems.use` | Opens the GPS menu. | | `/gps start ` | `gpssystems.use` | Starts navigation to a destination. | | `/gps stop` | `gpssystems.use` | Stops current navigation. | | `/gps list` | `gpssystems.use` | Lists available destinations. | | `/gps admin` | `gpssystems.admin` | Opens the admin menu. | | `/gps reload` | `gpssystems.admin` | Reloads config, languages, destinations and network data. | | `/gps set ` | `gpssystems.admin` | Creates a destination at your current location. | | `/gps point ` | `gpssystems.admin` | Creates a route point/intersection at your current location. | | `/gps connect ` | `gpssystems.admin` | Connects two route points. | | `/gps link ` | `gpssystems.admin` | Links a public destination to a route point. | | `/gps builder` | `gpssystems.admin` | Toggles route builder mode. | | `/gps editor` | `gpssystems.admin` | Toggles network editor overlay. | | `/gps tool` | `gpssystems.admin` | Gives admin GPS tools. | | `/gps map` | `gpssystems.admin` | Gives a GPS map. | | `/gps tp ` | `gpssystems.admin` | Teleports to a destination. | | `/gpstp ` | `gpssystems.admin` | Teleports to a destination. | | `/tp ` | `gpssystems.admin` | Short admin teleport alias if available. | ## Permissions | Permission | Default | Description | | --- | --- | --- | | `gpssystems.use` | `true` | Allows players to use GPS menus and navigation. | | `gpssystems.admin` | `op` | Allows admin tools, editing, reload and teleport commands. | ## Configuration Files ### `config.yml` Controls global behavior: - Language selection. - GPS map zoom and schematic mode. - Automatic GPS map on first join. - Route following corridor. - Lane matching. - Wrong-direction matching. - Dynamic recalculation. - Destination local/direct dotted segments. - Boss bar, action bar and particles. - Audio and visual behavior. Important setting: ```yaml settings: give-gps-map-on-first-join: true ``` This gives new players a GPS map automatically. ### `destinations.yml` Stores public server destinations, private player destinations and category styles. Example public destination: ```yaml destinations: spawn: enabled: true display-name: "Spawn" description: "Main server spawn." world: "world" x: 0.5 y: 64.0 z: 0.5 yaw: 0.0 pitch: 0.0 icon: "COMPASS" permission: "" category: "Spawn" ``` Category styles define how destinations appear on the GPS map: ```yaml category-styles: enabled: true color-labels: true rules: police: color: "#3B82F6" symbol: "P" categories: - "Police" pattern: - ".###." - "#####" - "##.##" - ".###." - "..#.." ``` ### `network.yml` Stores the route network: - `points`: intersections/nodes. - `streets`: named street groups. - `edge-streets`: link-to-street mapping. - `edge-rules`: one-way, blocked or weighted roads. - `destination-points`: public destination to network point links. Most servers should edit this with in-game tools, not manually. ## Editing Destination Icons In Game ![CATEGORIES BANNER](https://mrdino.es/wp-content/uploads/2026/06/GPS-BANNER-7.png) Admins can edit public destination icons from the `Public Destinations` menu. - Left click: start navigation. - Right click: rename destination. - Shift-click: set the destination icon using the item in your cursor or main hand. The icon is saved into `destinations.yml` as the Bukkit material name. ## Building Roads And Intersections Use `GPS Intersection Tool` to create and link intersections. The first clicked node and second clicked node define the direction used when creating directional links. Direction indicators are shown visually with particles so admins can see one-way and two-way routes. Use `GPS Remover Tool` to remove links or intersections while looking at them. Use `GPS Undo Tool` if you need to revert a recent network edit. ## Traffic Rules Traffic rules live in `network.yml` under `edge-rules`. Cost multipliers can influence routing: - `1.0`: normal road. - `2.0`: less preferred route. - `0.5`: preferred/fast route. ![TRAFFIC RULES BANNER](https://mrdino.es/wp-content/uploads/2026/06/GPS-BANNER-5.png) ## Route Behavior ![RECALC. BANNER](https://mrdino.es/wp-content/uploads/2026/06/GPS-BANNER-6.png) GPS Systems tries to keep routes stable while still correcting mistakes quickly: - It follows the active route instead of recalculating constantly. - It detects when players leave the route. - It checks lane/direction when configured. - It can add dotted local segments when the destination is beside the road or very close to the player. - It greys out completed map route sections. Key options: ```yaml navigation: dynamic-recalculate: true lane-match-recalculate: true route-direction-match: true destination-local-direct: true destination-local-direct-player-radius: 70.0 ``` ## Recommended Setup Tips - Place intersections at meaningful road joins, lane splits and turn points. - Avoid extremely long road links if the road has curves or multiple entrances. - Use one-way rules for separated lanes. - Use categories for readable destination menus and map colors. - Keep destination icons simple and recognizable. - Test routes from several directions, not only from spawn. ## 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. **_PLUGIN IS ON BETA PHASE, BUGS MIGHT APPEAR !!! For full guide go to: [https://mrdino.es/gps/](https://mrdino.es/gps/)_** ![END BANNER](https://mrdino.es/wp-content/uploads/2026/06/GPS-BANNER-FINAL.png)

GPS Systems

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details