SimpleGPS

SimpleGPS

SimpleGPS is a modern, lightweight GPS/waypoint plugin for Paper/Spigot 1.21+.
Give your players a clean /gps GUI to save locations and instantly track them with actionbar navigation, title feedback, soft sounds, and a premium destination marker.

Designed to feel like a paid plugin: bright, clean UI, consistent messages, and fast performance.

⮞ Why SimpleGPS?

✘ Premium-feeling GUI waypoint menu (fast, clean, modern)
✘ Per-player GPS tracking with direction guidance + distance
✘ Lightweight and optimized (no heavy loops, safe checks, stable behavior)
✘ File-based storage: one YAML file per location
✘ Fully customizable texts (messages + GUI strings)

⮞ Core Features

GPS Menu (GUI)

➟ Open with /gps
➟ Clean layout with navigation controls
➟ Sorting + pagination support (server-friendly)
➟ Click a location to start tracking instantly
➟ Utility buttons (refresh/help/close/stop tracking)

Management

➟ Save your current location with /gps add <name...>
➟ Remove with /gps remove <name...>
➟ Edit description with /gps desc <name...> <desc...>
➟ Data persists after restart
➟ Each location supports custom colors, font styles, and material-based icons

GPS Tracking (Per-player)

➟ Actionbar navigation displays direction, target name, and distance
➟ Cross-world safe handling (won’t spam / won’t break)
➟ Titles show GPS start and destination reached
➟ Auto-stop when player reaches the configurable radius

Visual Marker & Immersive Feedback

➟ Destination marker with a ground particle ring and floating particles
➟ Soft sounds for start, navigation updates, and arrival

Localization & Customization

➟ All player-facing text is configurable via YAML files
➟ Tracking options are fully configurable (intervals, radius, marker settings, sounds)

⮞ Showcase

GPS Menu

GPS Function

⮞ Commands

➜ /gps ➜ Open the GPS menu
➜ /gps add <name...> ➜ Save your current location
➜ /gps remove <name...> ➜ Remove a saved location
➜ /gps desc <name...> <desc...> ➜ Edit location description

➜ /gps color <name...> <color> ➜ Set location color
➜ Examples: sky, aqua, lime, gold, violet, #7AFFC1, grad:#00FFFF:#7AFFC1

➜ /gps font <name...> <font> ➜ Set location font style
➜ Fonts: normal, bold, smallcaps, bold_smallcaps

➜ /gps icon <name...> <icon> ➜ Set location icon material
➜ Examples: COMPASS, BEACON, ENDER_PEARL, MAP, CHEST

➜ /gps help ➜ Show help
➜ /gps version ➜ Show plugin version

⮞ Permissions

➜ gps.menu.use ➜ Use /gps menu
➜ gps.setup ➜ Use /gps add
➜ gps.remove ➜ Use /gps remove
➜ gps.description ➜ Use /gps desc
➜ gps.color ➜ Use /gps color
➜ gps.font ➜ Use /gps font
➜ gps.icon ➜ Use /gps icon
➜ gps.help ➜ Use /gps help
➜ gps.version ➜ No permission required

⮞ Data & Storage

➟ Each saved location is stored as a separate YAML file (name/key, world coords, owner info, description, timestamps, style: color/font/icon)
➟ Storage folder: plugins/SimpleGPS/locations/

⮞ Lightweight & Optimized

➟ Async file I/O (no main-thread blocking)
➟ Cached locations in memory
➟ Per-player tracking tasks only when needed
➟ Safe cleanup on quit/kick/reload

⮞ Requirements

➟ Java 21
➟ Paper/Spigot 1.21+
➟ No external dependencies needed

⮞ Installation

Put SimpleGPS.jar into your /plugins folder
Restart the server
Run /gps

⮞ Support / Suggestions

If you find a bug or want features like import/export, categories, global/admin waypoints, or economy integration, feel free to request it.