Compatibility
Minecraft: Java Edition
26.1.x
1.21.x
Platforms
Links
Tags
Creators
Details
Licensed ARR
Published 5 months ago

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
- Put
SimpleGPS.jarinto your/pluginsfolder - Restart the server
- Run
/gps
⮞ Support
Need help, found a bug, or have feature suggestions?
Discord Support: https://discord.gg/E8Jw9KrTb2



