IceGPS | Ultimate Roleplay GPS & Fast Travel ⚡

❄️ IceGPS
Navigate. Travel. Discover.
IceGPS is a modern and immersive Roleplay GPS & Fast Travel system for Minecraft servers.

Designed for Roleplay, Citybuild, SMP, and other immersive server environments, IceGPS provides players with an intuitive GPS interface for discovering locations, navigating across the world, and traveling instantly through a polished Fast Travel system.

✦ Features
Advanced GPS Navigation
Open the GPS with:

/gps

or simply right-click the special IceGPS Compass.

Players can browse all available destinations through a clean and animated GUI.

When a destination is selected, IceGPS provides:

• Live distance tracking
  
  
• Direction indicator
  
  
• ️ Destination information
  
  
• Minecraft Compass navigation
  
  
• ActionBar distance display
  
  
• Automatic destination detection
  
  
• ✅ Arrival notifications

Example:

Hospital • 284m • NE

The distance automatically updates while the player travels.

⚡ Fast Travel
Right-click any destination to open the Fast Travel menu.

Players can preview the destination and its cost before confirming.

Fast Travel includes:

• Vault Economy support
  
  
• ✅ Confirmation GUI
  
  
• Double-click protection
  
  
• ️ Transaction validation
  
  
• ✨ Cinematic teleport animation
  
  
• Smooth vertical ascension
  
  
• ☁️ Hover effect
  
  
• ⬇️ Smooth descent
  
  
• ✨ Arrival particles
  
  
• Sound effects
  
  
• Titles and ActionBar effects

The player smoothly rises into the air before being transported to the destination, creating a much more immersive Roleplay experience than a simple instant teleport.

️ Custom GPS Locations
Server administrators can easily create locations directly in-game.

Commands
/gps add <id>
/gps set <id>
/gps edit <id>
/gps remove <id>
/gps info <id>
/gps list

Example:

/gps add hospital

This creates a GPS destination at the administrator's current location.

Locations can contain:

• Name
  
  
• Description
  
  
• Category
  
  
• Icon
  
  
• Coordinates
  
  
• Fast Travel price
  
  
• Navigation settings
  
  
• Arrival radius
  
  
• Display priority
  
  
• Custom sounds
  
  
• Custom particles

Animated GUI
IceGPS includes a polished inventory-based GPS interface.

Features include:

• Animated interface
  
  
• Categories
  
  
• Pagination
  
  
• Destination icons
  
  
• Active GPS indicator
  
  
• Fast Travel confirmation
  
  
• Stop GPS button
  
  
• Back / Next navigation
  
  
• Configurable sounds
  
  
• Configurable items
  
  
• Configurable lore

The entire interface is configurable.

Stop GPS
Players can stop navigation at any time:

/gps stop

or directly from the GUI using the:

STOP GPS

button.

When GPS is stopped:

• Navigation ends
  
  
• Distance display disappears
  
  
• BossBar is removed
  
  
• Navigation particles stop
  
  
• Compass tracking stops
  
  
• Temporary navigation state is cleaned up

Saved Locations
Players can save their own GPS destinations.

/gps save <name>
/gps saved
/gps delete <name>

Saved locations can be accessed directly from the GPS GUI.

GPS Compass Item
IceGPS includes a dedicated Compass item.

Give it using:

/gps giveitem <player>

Right-clicking the special Compass automatically opens the GPS GUI.

The item uses secure internal identification and cannot be activated simply by renaming a normal Compass.

PlaceholderAPI Support
IceGPS includes its own PlaceholderAPI expansion.

General
%icegps_active%
%icegps_has_destination%
%icegps_destination%
%icegps_distance%
%icegps_distance_meters%
%icegps_distance_km%
%icegps_direction%
%icegps_world%
%icegps_x%
%icegps_y%
%icegps_z%
%icegps_fasttravel_cost%

GPS Item
%icegps_item%

Fast Travel
%icegps_fasttravel_active%
%icegps_fasttravel_destination%
%icegps_fasttravel_progress%

These placeholders can be used in compatible:

• Scoreboards
  
  
• Tablists
  
  
• Holograms
  
  
• Chat systems
  
  
• GUIs
  
  
• Other plugins

Vault Support
Fast Travel can use Vault-compatible economy plugins.

This allows server owners to integrate IceGPS with their existing economy system without creating a separate currency.

SQLite Database
IceGPS uses SQLite for persistent data.

The database stores:

• GPS locations
  
  
• Categories
  
  
• Player GPS state
  
  
• Saved locations
  
  
• Player settings
  
  
• Fast Travel transactions

The database layer uses prepared statements, transactions, indexing, and safe persistence.

️ Secure & Lightweight
IceGPS was designed with performance and reliability in mind.

Features include:

• Secure GUI identifiers
  
  
• PDC-based GPS item identification
  
  
• Transaction locking
  
  
• Duplicate purchase protection
  
  
• Safe teleport handling
  
  
• Navigation state cleanup
  
  
• Async database operations
  
  
• Centralized navigation updates
  
  
• Memory leak prevention

IceGPS does not create a separate repeating task for every player.

Fully Configurable
IceGPS provides separate configuration files for:

config.yml
messages.yml
database.yml
locations.yml
categories.yml
gui.yml

You can configure:

• GUI design
  
  
• Colors
  
  
• Messages
  
  
• Sounds
  
  
• Particles
  
  
• Fast Travel animation
  
  
• Location appearance
  
  
• Destination categories
  
  
• ActionBar
  
  
• BossBar
  
  
• GPS Item
  
  
• Navigation behavior

Color codes such as:

&b
&f
&7
&c
&a
&l

are supported throughout the plugin.

Installation

1. Download IceGPS.jar
   
   
2. Place it into your server's:

/plugins

1. Install Vault if you want Economy-powered Fast Travel.
   
   
2. Install PlaceholderAPI if you want Placeholder support.
   
   
3. Restart the server.
   
   
4. Configure your locations.

Then use:

/gps

Perfect For
IceGPS is especially suited for:

• Roleplay Servers
  
  
• Citybuild
  
  
• Towny
  
  
• SMP
  
  
• Survival
  
  
• Modern RPG Servers
  
  
• Open-world Minecraft Servers

❄️ IceGPS
Navigate. Travel. Discover.
A modern GPS experience built for Minecraft Roleplay.