
Advanced GPS navigation with interactive GUI menus, realtime Bossbar/Actionbar tracking, visual destination particles, Economy integration, permission limits, and SQLite support.

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, bossbar navigation, visual destination markers, public and private waypoints, waypoint sharing, and optimized per-player GPS systems.
Built to feel like a premium-quality plugin with modern UI design, clean feedback systems, lightweight performance, safe storage handling, detailed configuration, and extensive customization.


/gps/gps add <name>/gps remove <name>/gps rename <old> <new>/gps info <name>/gps list/gps desc <name> <description>/gps public <name>/gps private <name>/gps share <player> <name>/gps nearestNearest Location/gps stopACTIONBARBOSSBARBOTHTemplate data can include:
10s, 5m, and 1h| Command | Description |
|---|---|
/gps |
Open the GPS menu |
/gps add <name> |
Save current location |
/gps remove <name> |
Remove a location |
/gps rename <old> <new> |
Rename a waypoint |
/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 public <name> |
Make a waypoint public |
/gps private <name> |
Make a waypoint private |
/gps share <player> <name> |
Share a waypoint with another player |
/gps nearest |
Find the nearest accessible waypoint |
/gps info <name> |
Show waypoint information |
/gps list |
List accessible waypoints |
/gps stop |
Stop active tracking |
/gps teleport <name> |
Teleport to a waypoint |
/gps reload |
Reload SimpleGPS configuration and data |
/gps help |
Show help |
/gps version |
Show plugin version |
| Command | Description |
|---|---|
/gps template create <templateName> |
Create a waypoint template |
/gps template apply <templateName> <waypoint> |
Apply a template to a waypoint |
/gps template delete <templateName> |
Delete a template |
/gps template list |
List available templates |
/gps template info <templateName> |
Show template information |
| Command | Description |
|---|---|
/gps backup |
Show backup help |
/gps backup create |
Create a backup |
/gps backup list |
List backups |
/gps backup restore <file> |
Restore a backup |
/gps export |
Export waypoint data |
/gps export all |
Export all waypoint data |
/gps import <file> |
Import waypoint data |
| Command | Description |
|---|---|
/gps storage migrate yaml sqlite |
Migrate YAML data to SQLite |
/gps storage migrate sqlite yaml |
Migrate SQLite data to YAML |
sky
aqua
lime
gold
violet
#7AFFC1
grad:#00FFFF:#7AFFC1
normal
bold
smallcaps
bold_smallcaps
COMPASS
BEACON
ENDER_PEARL
MAP
CHEST
DIAMOND
EMERALD
NETHER_STAR
ENDER_EYE
BOOK
| 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 |
gps.rename |
Use /gps rename |
gps.info |
Use /gps info |
gps.list |
Use /gps list |
gps.stop |
Use /gps stop |
gps.nearest |
Use /gps nearest |
gps.public.use |
Use public waypoints |
gps.public.manage |
Manage public/private waypoint status |
gps.share |
Share waypoints |
gps.share.receive |
Receive shared waypoints |
gps.template.use |
Use waypoint templates |
gps.template.manage |
Manage waypoint templates |
gps.teleport |
Use /gps teleport |
gps.reload |
Use /gps reload |
gps.backup |
Use backup commands |
gps.import |
Use import commands |
gps.export |
Use export commands |
gps.storage.migrate |
Use storage migration commands |
gps.limit.10 |
Set waypoint limit to 10 |
gps.limit.30 |
Set waypoint limit to 30 |
gps.limit.50 |
Set waypoint limit to 50 |
gps.limit.bypass |
Bypass waypoint limits |
gps.cooldown.bypass |
Bypass cooldowns |
gps.cost.bypass |
Bypass economy costs |
gps.admin |
Access all admin features |
SimpleGPS is built with safe and flexible storage handling.
plugins/SimpleGPS/locations/
Each waypoint stores:
When the plugin starts, SimpleGPS will generate a clean folder structure.
plugins/SimpleGPS/
├── config.yml
├── messages/
│ ├── en_US.yml
│ └── id_ID.yml
├── locations/
│ ├── example-waypoint.yml
│ └── ...
├── templates/
│ ├── shop.yml
│ ├── spawn.yml
│ └── ...
├── backups/
│ ├── simplegps-backup-YYYY-MM-DD-HH-mm.zip
│ └── ...
├── exports/
│ ├── simplegps-export-YYYY-MM-DD-HH-mm.yml
│ └── ...
└── database/
└── simplegps.db
| Folder / File | Description |
|---|---|
config.yml |
Main plugin configuration |
messages/en_US.yml |
English fallback messages |
messages/id_ID.yml |
Indonesian messages |
locations/ |
YAML waypoint storage |
templates/ |
Admin waypoint templates |
backups/ |
Manual and automatic backups |
exports/ |
Exported waypoint data |
database/simplegps.db |
Optional SQLite database |
SimpleGPS includes a clean and organized configuration file.
language:
default: "id_ID"
fallback: "en_US"
storage:
type: YAML # YAML or SQLITE
sqlite:
file: "database/simplegps.db"
tracking-display:
mode: BOTH # ACTIONBAR, BOSSBAR, BOTH
update-interval-ticks: 20
actionbar:
text: "&b⟐ {waypoint} &7| &f{distance} blocks away"
bossbar:
enabled: true
color: BLUE
style: SOLID
text: "&b⟐ {waypoint} &7| &f{distance} blocks away"
waypoints:
public-enabled: true
sharing-enabled: true
nearest-enabled: true
allow-cross-world-tracking: false
backup:
enabled: true
auto-backup:
enabled: true
interval-hours: 12
keep-last: 10
cost:
enabled: false
SimpleGPS is designed to remain lightweight even on larger servers.
SimpleGPS is designed for Paper/Spigot 1.21+.
The plugin is not designed to block compatible patch versions unnecessarily. If your server uses a compatible 1.21.x version, SimpleGPS will try to keep the main system working safely.
Supported environment:
Optional:
SimpleGPS.jarSimpleGPS.jar into your /plugins folder/gpsplugins/SimpleGPS/config.yml
plugins/SimpleGPS/messages/
Need help, found a bug, or have feature suggestions?
Discord Support:
https://discord.gg/PDr4UEDtNa