GPSPlugin

A simple lightweight plugin that adds a easy to use compass-gps.

Загрузки: 481
Подписчики: 3
Обновлён: 3 июня 2025 г.
Лицензия: LGPL-3.0-only

Опубликован 21 февраля 2025 г.

GPS Plugin

A Bukkit/Spigot Minecraft plugin that allows players to create a GPS compass to navigate to specific coordinates. Players can reroute the compass a limited number of times before it breaks.

Join the support discord - https://dsc.gg/mosaic

Features

Players can set a GPS compass pointing to specified coordinates using /gps <x> <z>.\
GPS can be set to a hidden location, hiding the destination coordinates.
The compass can be rerouted up to a configurable number of times using /reroute <x> <z>.
The number of reroutes left is displayed in the item lore.
The compass breaks after reaching the reroute limit, playing an item break sound.
Requires players to have gps.use permission to use the commands.
The maximum reroutes allowed is configurable in config.yml.
Right-clicking a compass will create a line of particles that point in the direction of the destination.

Commands

Command	Description	Permission
`/gps <x> <z> <hidden:true/false>`	Creates a GPS compass pointing to the given coordinates, with the option to hide the destination from the item lore. Requires 10 compasses.	`gps.use`
`/reroute <x> <z>`	Updates the compass to a new location (limited reroutes).	`gps.use`

Permissions

Permission	Description	Default
`gps.use`	Allows use of `/gps` and `/reroute` commands.	`true`

Configuration (`config.yml`)

You can configure the maximum number of reroutes before the compass breaks.

max-reroutes: 3

(Default: 3 reroutes before breaking)

How It Works

A player runs /gps <x> <z> while holding at least 10 compasses.
The command consumes 10 compasses and gives them a special GPS compass.
The GPS compass points to the entered coordinates.
The player can use /reroute <x> <z> to change the destination (up to the max reroutes set in config.yml).
Once the reroutes are exhausted, the compass disappears, playing an item break sound.

Installation

Download the plugin JAR and place it in your plugins folder.
Restart your server to generate the config file.
Edit config.yml in the plugin folder if needed.
Reload the server to apply changes.

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).
You are free to use, modify, and distribute this plugin under the terms of the GPL-3.0 license.

For more details, see the GNU GPL v3 License.

This fie was generated by an LLM

Ченджлог

1.2.4Релиз1.21.3, 1.21.4, 1.21.5 · 3 июня 2025 г.

GPS destination can now be hidden in the lore, hiding the destination coordinates!

Players in creative no longer need to have 10 compass to make a GPS.

Fixed particle bug, cosmetic changes.

1.2.0Релиз1.16.3, 1.16.4, 1.16.5 · 26 февраля 2025 г.

Right clicking a compass now shows a line of particles in the direction of the destination. Particle type may be customizable in the future, currently it is not something I wanted to put the time into.

What's Changed

Adding particle pointing to destination by @ItsTNJS in https://github.com/ItsTNJS/GPSPlugin/pull/1

New Contributors

@ItsTNJS made their first contribution in https://github.com/ItsTNJS/GPSPlugin/pull/1

Full Changelog: https://github.com/ItsTNJS/GPSPlugin/compare/1.1.0...1.2.0

1.1.2Релиз1.16.3, 1.16.4, 1.16.5 · 23 февраля 2025 г.

GPS Plugin - Version 1.1.2 Release Notes

New Features & Improvements

🔹 Reroute Limit & Breaking Mechanic

Each GPS compass can now be rerouted a limited number of times before breaking.
The number of reroutes left is stored in NBT data and displayed in the item lore.
When the reroute limit is reached, the compass breaks and disappears, playing an item break sound.

🔹 Configurable Reroute Limit

The maximum reroutes allowed per compass is now configurable in config.yml:
```
max-reroutes: 3
```
(Default: 3 reroutes before breaking)

🔹 Improved Lore Display

The GPS compass now shows the remaining reroutes in its lore beneath the coordinates.

🔹 Permission System

Players must now have the gps.use permission to use /gps and /reroute.

Bug Fixes & Optimizations

✅ Fixed a NullPointerException caused by the missing reroute command in config.yml.
✅ Improved inventory handling to ensure proper item removal and updates.
✅ Enhanced NBT validation, preventing players from forging GPS compasses.

How to Update

Replace the old JAR file with the new version in your plugins folder.
Restart your server to apply changes.
Modify config.yml if you want to adjust the max reroutes.

🚀 Enjoy the update, and let us know if you have any feedback!

Written with LLM