ModsJava
SimpleGPS - GPS Menu, Tracking & Waypoints
Java mod listed for Minecraft 1.21–26.x. Download on the author's site.
SimpleGPS Modern GPS & Waypoint Plugin for Paper/Spigot 1.21+ Lightweight • Modern UI • Realtime Tracking • Bossbar Navigation • Fully Customizable …
⬇ Download on SpigotSimpleGPS
Modern GPS & Waypoint Plugin for Paper/Spigot 1.21+
Lightweight • Modern UI • Realtime Tracking • Bossbar Navigation • Fully Customizable
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SHOWCASE
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
OVERVIEW
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, realtime waypoint tracking, actionbar navigation, bossbar navigation, direction guidance, visual destination markers, public and private waypoints, waypoint sharing, and optimized per-player GPS systems.
SimpleGPS is 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.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
![[IMG]](//proxy.spigotmc.org/ab6369708108ba4632843e241fa1b09ed63c0dd1/68747470733a2f2f692e6962622e636f2e636f6d2f744d7162633368462f6770732d6d656e752e6a7067)
![[IMG]](//proxy.spigotmc.org/5ae0ec4c302f37b65e77485b9e575adfe3194635/68747470733a2f2f692e6962622e636f2e636f6d2f707664424b304d7a2f747261636b696e672d6d6f64652e6a7067)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FEATURES
Modern GPS Menu
• Open the menu using /gps
• Clean and responsive GUI layout
• Private waypoint section
• Public waypoint section
• Shared waypoint section
• Nearest location button
• Stop tracking button
• Sorting and pagination support
• Instant waypoint tracking
• Waypoint status, distance, world, and owner display
Waypoint Management
• Save locations using /gps add <name>
• Remove locations using /gps remove <name>
• Rename locations using /gps rename <old> <new>
• Edit descriptions using /gps desc <name> <description>
• View waypoint details using /gps info <name>
• List accessible waypoints using /gps list
• Persistent data after restart
• Custom colors, fonts, and material icons
• Owner-based waypoint data
• Safe handling for missing or invalid waypoint files
Realtime GPS Tracking
• Realtime actionbar navigation
• Optional bossbar navigation
• Direction guidance and distance tracking
• Automatic arrival detection
• Cross-world safe handling
• Start and arrival title feedback
• Per-player GPS sessions
• Tracking cleanup on logout, world change, reload, and plugin disable
Direction Guidance
SimpleGPS helps players understand where to go while tracking a waypoint.
Supported directions:
• Forward
• Left
• Right
• Behind
• Up
• Down
• Arrived
Example tracking display:
⟐ Shop | 238 blocks | Go Forward ↟
Bossbar Tracking Mode
• Premium-looking bossbar navigation
• Configurable bossbar text
• Configurable bossbar color
• Configurable bossbar style
• Supports ACTIONBAR, BOSSBAR, and BOTH
• Bossbar automatically disappears when tracking stops, player arrives, logs out, or changes world
Destination Marker
• Visual marker at the waypoint location
• Particle destination marker
• Optional vertical marker effect
• Optional floating waypoint name
• Only shown while the player is tracking
• Automatically cleaned up when tracking ends
Public, Private & Shared Waypoints
• Private player waypoints
• Public server waypoints
• Shared waypoints between players
• Admin-managed public locations
• Permission-based access
• GUI indicator for public, private, and shared waypoints
Useful for:
• Spawn
• Shop
• Crates
• RTP
• Arena
• Banker
• Jobs
• Quests
• Event locations
Nearest Waypoint
• Find the nearest accessible waypoint using /gps nearest
• Checks only waypoints in the same world
• Respects player permissions
• Respects public, private, and shared waypoint access
• Clickable output to start tracking
• Available as a GUI button
Admin Waypoint Templates
• Create reusable waypoint templates
• Apply template styles to waypoints
• Speed up server setup
• Keep public server waypoints visually consistent
Templates can include:
• Icon
• Color
• Font
• Description
• Category
• Particle
• Sound
Backup, Export & Import
• Manual backup support
• Auto-backup support
• Export waypoint data
• Import waypoint data
• Restore backups
• Safe duplicate handling
• Useful for server migration and data safety
Optional SQLite Storage
• YAML remains the default storage
• SQLite is optional
• Designed for larger servers
• Database file auto-generation
• Safe table creation
• Optional storage migration support
Optional Economy Cost System
• Vault-based economy support
• Disabled by default
• No economy dependency required unless enabled
• Optional cost for selected GPS actions
• Bypass permission support
• Safe validation before charging money
Fully Configurable
• Configurable messages
• Indonesian language support
• English fallback language support
• Custom GUI strings
• Configurable actionbar and bossbar text
• Configurable sounds and particles
• Adjustable tracking intervals
• Customizable marker behavior
• Configurable storage type
• Configurable backup system
• Configurable console startup banner and reload summary
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
COMMANDS
Spoiler: Click to view commands
/gps — Open GPS menu
/gps add <name> — Save current location
/gps remove <name> — Remove location
/gps rename <old> <new> — Rename waypoint
/gps desc <name> <description> — Edit waypoint 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 waypoint public
/gps private <name> — Make waypoint private
/gps share <player> <name> — Share waypoint with another player
/gps nearest — Find nearest accessible waypoint
/gps info <name> — Show waypoint information
/gps list — List accessible waypoints
/gps stop — Stop active tracking
/gps teleport <name> — Teleport to waypoint
/gps reload — Reload SimpleGPS
/gps help — Show help
/gps version — Show plugin version
/gps add <name> — Save current location
/gps remove <name> — Remove location
/gps rename <old> <new> — Rename waypoint
/gps desc <name> <description> — Edit waypoint 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 waypoint public
/gps private <name> — Make waypoint private
/gps share <player> <name> — Share waypoint with another player
/gps nearest — Find nearest accessible waypoint
/gps info <name> — Show waypoint information
/gps list — List accessible waypoints
/gps stop — Stop active tracking
/gps teleport <name> — Teleport to waypoint
/gps reload — Reload SimpleGPS
/gps help — Show help
/gps version — Show plugin version
Template Commands
Spoiler: Click to view template commands
/gps template create <templateName> — Create waypoint template
/gps template apply <templateName> <waypoint> — Apply template to waypoint
/gps template delete <templateName> — Delete template
/gps template list — List templates
/gps template info <templateName> — Show template information
/gps template apply <templateName> <waypoint> — Apply template to waypoint
/gps template delete <templateName> — Delete template
/gps template list — List templates
/gps template info <templateName> — Show template information
Backup & Import Commands
Spoiler: Click to view backup commands
/gps backup — Show backup help
/gps backup create — Create backup
/gps backup list — List backups
/gps backup restore <file> — Restore backup
/gps export — Export waypoint data
/gps export all — Export all waypoint data
/gps import <file> — Import waypoint data
/gps backup create — Create backup
/gps backup list — List backups
/gps backup restore <file> — Restore backup
/gps export — Export waypoint data
/gps export all — Export all waypoint data
/gps import <file> — Import waypoint data
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
STYLE EXAMPLES
Color Examples
Spoiler: Click to view color examples
sky
aqua
lime
gold
violet
#7AFFC1
grad:#00FFFF:#7AFFC1
aqua
lime
gold
violet
#7AFFC1
grad:#00FFFF:#7AFFC1
Font Styles
Spoiler: Click to view font styles
normal
bold
smallcaps
bold_smallcaps
bold
smallcaps
bold_smallcaps
Icon Examples
Spoiler: Click to view icon examples
COMPASS
BEACON
ENDER_PEARL
MAP
CHEST
DIAMOND
EMERALD
NETHER_STAR
ENDER_EYE
BOOK
BEACON
ENDER_PEARL
MAP
CHEST
DIAMOND
EMERALD
NETHER_STAR
ENDER_EYE
BOOK
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PERMISSIONS
Spoiler: Click to view permissions
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 — Use /gps version
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 — Waypoint limit 10
gps.limit.30 — Waypoint limit 30
gps.limit.50 — Waypoint limit 50
gps.limit.bypass — Bypass waypoint limits
gps.cooldown.bypass — Bypass cooldowns
gps.cost.bypass — Bypass economy costs
gps.admin — Access all admin features
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 — Use /gps version
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 — Waypoint limit 10
gps.limit.30 — Waypoint limit 30
gps.limit.50 — Waypoint limit 50
gps.limit.bypass — Bypass waypoint limits
gps.cooldown.bypass — Bypass cooldowns
gps.cost.bypass — Bypass economy costs
gps.admin — Access all admin features
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
DATA & STORAGE
SimpleGPS uses safe and flexible storage handling.
YAML Storage
• Default storage type
• One file per waypoint
• Easy to edit manually
• Easy to backup
• Cached locations in memory
• Safe file handling
SQLite Storage
• Optional storage type
• Better for larger servers
• Single database file
• Auto table creation
• YAML remains default for lightweight usage
Stored under:
plugins/SimpleGPS/locations/
Each waypoint can store:
• Location coordinates
• World information
• Owner UUID
• Description
• Status
• Shared players
• Timestamps
• Style settings
• Icon settings
• Category
• Particle settings
• Sound settings
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GENERATED FOLDER STRUCTURE
When the plugin starts, SimpleGPS will generate a clean folder structure.
Code (Text):
plugins/SimpleGPS/
├── config.yml
├── messages/
│ ├── en_US.yml
│ └── id_ID.yml
├── locations/
├── templates/
├── backups/
├── exports/
└── database/
└── simplegps.db
├── config.yml
├── messages/
│ ├── en_US.yml
│ └── id_ID.yml
├── locations/
├── templates/
├── backups/
├── exports/
└── database/
└── simplegps.db
• 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
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
LIGHTWEIGHT & OPTIMIZED
SimpleGPS is designed to remain lightweight even on larger servers.
• Async file operations
• Cached waypoint system
• Per-player tracking tasks only when required
• No unnecessary global tracking loops
• Reduced scheduler usage
• Safe cleanup handling
• Low memory usage
• Efficient GPS update handling
• Bossbar cleanup protection
• Reload-safe task handling
• Storage caching system
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
REQUIREMENTS
• Java 21
• Paper/Spigot 1.21+
• No required external dependencies
Optional:
• Vault, only if the economy cost system is enabled
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
INSTALLATION
1. Download SimpleGPS.jar
2. Put SimpleGPS.jar into your /plugins folder
3. Restart the server
4. Run /gps
5. Configure the plugin in plugins/SimpleGPS/config.yml
6. Edit messages in plugins/SimpleGPS/messages/
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SUPPORT & COMMUNITY
Need help, found a bug, or have feature suggestions?
Discord Support Server:
https://discord.gg/E8Jw9KrTb2
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 26.1
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
SimpleGPS - GPS Menu, Tracking & Waypoints is a free Minecraft Java mod. Compatible with Minecraft 1.21, 26.1. Downloaded 151 times (via Spigot). Download it and open it directly in the game.