📍 GPS PLUGIN – Smart Navigation for Minecraft

👤 Author: Orpdar
📜 Compatible with: PaperMC 1.21+

🧭 Description

🔹 Lightweight & intuitive plugin to let players save and navigate to specific world locations using a dynamic compass in the ActionBar.

✅ /gps – Starts navigation with a directional arrow and real-time distance
🛡️ Operators – Can save, remove, and manage global positions
📌 Save & navigate – Custom named locations
💬 Custom messages – Fully configurable via messages.yml
🌍 Multilingual – Default: English. Includes 🇮🇹 Italian, 🇩🇪 German, 🇪🇸 Spanish, 🇫🇷 French
📝 Easy to expand – Add more languages by editing messages.yml

🛰️ Navigation System

🎯 Direction – Displayed in ActionBar
🔁 Real-time updates – Direction and distance
🛑 Cancel anytime – With /gps stop
🔊 Sounds – For save, arrival, and language switch

🗂️ File Structure

📁 config.yml – Server language settings
📁 messages.yml – Language texts
📁 locations.yml – Saved positions and coordinates

🛠️ Main Commands

📍 /gps save – Save current location (OP only)
🧭 /gps – Start navigation to location
🔴 /gps stop – Stop active navigation
📋 /gps list – List all saved locations
♻️ /gps reload – Reload config/messages (OP only)
❌ /gps remove – Remove a saved location (OP only)
🆘 /gps help – Command help menu
ℹ️ /gps info – Plugin version, current language, saved points
🌐 /gps lang <it/en/de/fr/es> – Change plugin language (OP only)
🗺️ /gps – Open the navigation GUI

🔐 Permissions

🔑 gps.admin – Required for save/remove/reload/lang operations

✨ Extra Features

🎵 Sounds & animations – For important events
🧠 Charset detection – Uses Charset.defaultCharset()
🛡️ Safety checks – Auto-disables if plugin folder missing
📦 Language fallback – Defaults to English if translation is missing