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.



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

Template Commands

Backup & Import Commands


STYLE EXAMPLES

Color Examples

Font Styles

Icon Examples


PERMISSIONS


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.
Folder Details
• 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