SimpleGPS

!SimpleGPS

SimpleGPS is a modern, lightweight GPS & waypoint plugin for Paper/Spigot 1.21+.

Provide your players with a clean and immersive navigation experience using a modern /gps GUI, live waypoint tracking, actionbar navigation, visual destination markers, and optimized per-player GPS systems.

Built to feel like a premium-quality plugin with modern UI design, clean feedback systems, lightweight performance, and extensive customization.

---

⮞ Showcase

---

⮞ Features

Modern GPS Menu

• Open using /gps
• Clean and responsive GUI layout
• Navigation controls
• Sorting & pagination support
• Instant waypoint tracking
• Utility buttons for refresh, help, close, and stop tracking

Waypoint Management

• Save locations using /gps add <name>
• Remove locations using /gps remove <name>
• Edit descriptions using /gps desc <name> <description>
• Persistent data after restart
• Custom colors, fonts, and material icons for every waypoint

Advanced GPS Tracking

• Real-time actionbar navigation
• Direction guidance and distance tracking
• Automatic arrival detection
• Cross-world safe handling
• Start and arrival title feedback
• Per-player GPS sessions

Visual & Immersive Feedback

• Destination particle markers
• Floating waypoint effects
• Soft navigation sounds
• Arrival effects
• Clean and minimal visual design

Customization

• Fully configurable messages
• Custom GUI strings
• Configurable sounds & particles
• Adjustable tracking intervals
• Configurable marker behavior
• Flexible waypoint styling system

---

⮞ Commands

Command	Description
/gps	Open the GPS menu
/gps add <name>	Save current location
/gps remove <name>	Remove a location
/gps desc <name> <description>	Edit location description
/gps color <name> <color>	Set waypoint color
/gps font <name> <font>	Set waypoint font style
/gps icon <name> <icon>	Set waypoint icon
/gps help	Show help
/gps version	Show plugin version

Color Examples

sky
aqua
lime
gold
violet
#7AFFC1
grad:#00FFFF:#7AFFC1

Font Styles

normal
bold
smallcaps
bold_smallcaps

Icon Examples

COMPASS
BEACON
ENDER_PEARL
MAP
CHEST

---

⮞ Permissions

Permission	Description
gps.menu.use	Use /gps
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	Access version command

---

⮞ Storage System

• File-based YAML storage
• One file per waypoint
• Cached locations in memory
• Async file operations
• Safe data handling

Storage Path

plugins/SimpleGPS/locations/

Each waypoint stores:

• Location coordinates
• World information
• Owner UUID
• Description
• Timestamps
• Style settings
• Icon settings

---

⮞ Performance & Optimization

SimpleGPS is designed to remain lightweight even on larger servers.

Optimization Features

• Async file I/O
• Cached waypoint system
• Per-player tracking tasks only when required
• Reduced scheduler usage
• Safe cleanup handling
• Low memory usage
• Efficient GPS update handling

---

⮞ Requirements

• Java 21
• Paper/Spigot 1.21+
• No external dependencies required

---

⮞ Installation

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

---

⮞ Support

Need help, found a bug, or have feature suggestions?

Discord Support: https://discord.gg/E8Jw9KrTb2