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

Watch the 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

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

Font Styles

```txt normal bold smallcaps bold_smallcaps ```

Icon Examples

```txt 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

```txt 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