GPS Plugin – Smart Navigation for Minecraft

Author: Orpdar
Compatible with: PaperMC 1.21+

Description
A lightweight and intuitive plugin that allows players to save and navigate to specific world locations using a dynamic virtual compass displayed in the ActionBar.

✅ With /gps, players can start navigating to a saved point, receiving a directional arrow and real-time distance updates.
✅ Operators can manage, save, and remove locations for everyone.
✅ Save, remove, and navigate to custom locations.
✅ Customizable messaging system based on the server’s language (messages.yml).
✅ Multilingual support (default English. Included languages: Italian, German, Spanish, and French).
✅ Ability to add more languages (by editing messages.yml).

️ Active Navigation System:

• Shows direction via ActionBar.
  
  
• Dynamically updates direction and distance.
  
  
• Can be cancelled at any time with /gps stop.
  
  
• Audio system notifies events (saving, arrival, language change).
  

File Structure:

config.yml – Contains server language settings.
messages.yml – Contains message texts in different languages.
locations.yml – Stores saved locations with coordinates.

️ Main Features:

✅ /gps save – Save your current location (OP only)
/gps – Start navigation to a saved location
/gps stop – Stop active navigation
/gps list – List all saved locations
♻️ /gps reload – Reload locations and messages from file (OP only)
❌ /gps remove – Remove a saved location (OP only)
/gps help – Display the GPS command guide
ℹ️ /gps info – Show plugin information (version, locations, language)
/gps lang <it/en/de/fr/es> – Change the plugin language (config.yml, OP only)
/gps – Open the navigation graphical interface

️ System Permissions:

gps.admin
– Required to save, remove, reload, and change language.

✨ Extra Features:

• Sound animations for important events (e.g., saving, permission errors).
  
  
• Automatic detection of the system’s character set (Charset.defaultCharset()).
  
  
• Security checks during plugin startup (automatically disables if the plugin folder is missing).
  
  
• Fallback language: if a language is missing, it defaults to English.