GPS Map

🧭 GPS Navigation Mod (Client-Side)

GPS is a 100% Client-Side satellite map and smart road navigation mod for Minecraft 1.12.2.
It guides you through your built roads, offers an ultra-smooth (120+ FPS) minimap with cave support, and lets you share explored maps with friends!

                                  1.0.2 Update is coming!

🌟 Features

🚗 Smart Road GPS & Navigation

• Advanced Pathfinding: Calculates the fastest route strictly along your road network.
• Lane Centering: Centers the line in the median of any road width (3 to 24+ blocks wide).
• Directional Flow Control (NEW!): Fully supports One-Way and Two-Way streets with flawless routing logic that calculates the path exactly from your current location!
• Speed Limits & Street Names (NEW!): Dynamically displays the current street name and an authentic speed limit sign on your HUD as you drive or walk on the road.
• Road Visibility Toggle (NEW!): Choose whether individual road segments are colored and visible or completely hidden from the map and radar while keeping smart GPS navigation 100% active over them!
• No Corner Cutting: Stays 100% inside road intersections without clipping grass.
• Visual Guidance: Guides you with a smooth glowing line in the 3D world and on your mini-radar HUD.

🌈 Dynamic RGB & Chroma Rainbow System (NEW!)

• Interactive HSV Color Wheel: Sleek radial color picker with a draggable selector handle, brightness slider, and hex code input. Custom-color your Waypoints, Road Segments, HUD Borders, and Territory Zones with ease!
• Animated Chroma Waves: Turn on full dynamic rainbow mode for flowing Chroma waves on your 3D GPS route line and HUD minimap border!
• Dynamic Biome RGB Accents: When enabled, the HUD border smoothly adapts its glowing accent color to match your surrounding biome or dimension (Lush Greens, Ocean Blues, Desert Golds, Nether Crimson, Void Purple)!

🗺️ Territory & Color Area Zones (NEW!)

• Visual Draw Zone Tool: Click and drag directly on the fullscreen satellite map to define and color-code custom districts, territories, and safe zones.
• Real-Time Map & HUD Overlays: Displays crisp borders and translucent shaded areas on both the fullscreen map and HUD radar.
• Dynamic Zone HUD Indicator: Automatically detects and displays the active territory zone name in your HUD footer as you enter (e.g. [Downtown District], [Airport Safe Zone]).

🎨 Beautiful, Accurate Satellite Map

• Dynamic Mod Block Colors (NEW!): The map engine intelligently reads 2D texture sprites of ANY unknown or modded block to calculate its exact true average color. No more ugly grey blocks for custom mods!
• Rich Xaero-Style Colors (NEW!): Features vibrant biomes, natural grass/foliage shading, and realistic water depth gradients.
• Topography Hillshading: Beautiful 3D depth perception based on terrain height.
• Subterranean Cave Mode: Keeps full surface trees and mountains intact; automatically reveals hollow tunnels and underground chambers when descending into caves.
• Zero Lag: Asynchronous background chunk writer with 0% CPU impact. Real-time updates within 3 seconds when placing/breaking blocks.

🎛️ Fully Customizable HUD Radar

• HUD Settings Menu (NEW!): Easily drag, drop, and resize your minimap anywhere on the screen!
• Custom Borders & Accents (NEW!): Switch between Dynamic Biome, Chroma Rainbow, Custom RGB, or Classic Dark border styles.
• Radar Visibility Toggles (NEW!): Toggle roads, waypoints, and territory zones on/off your minimap HUD at any time.

🖼️ Custom PNG Waypoint Icons!

• Put any .png image in: 📁 .minecraft/gps_maps/custom_images/
• When creating a waypoint on the map (M key), select your custom image to display it as a custom badge icon on the map!

💾 Share Explored Maps, Zones & Road Configs with Friends!

• Explored map data, zones, and road networks are automatically organized per server in: 📁 .minecraft/gps_maps/servers/<server_ip>/
• Just copy the server folder and send it to your friends — they will immediately have your entire explored map, waypoints, custom zones, and drawn road networks!
• Safe Fallback: If a shared config uses a custom mod block that your friend doesn't have installed, it automatically falls back to Black Concrete safely without errors!

⌨️ Controls

| Key / Mouse | Action |
| :--- | :--- |
| M | Open Fullscreen Satellite Map & Waypoints |
| H | Toggle HUD Minimap On/Off |
| Mouse Drag | Pan around the map |
| Scroll Wheel | Smooth Zoom In / Zoom Out |
| Right Click | Create a Waypoint or interact with Road Nodes |

---

💻 Commands

- /gps to <x> <z> [y] — Start GPS navigation to coordinates.
- /gps clear (or /gps stop) — Cancel active navigation.
- /block set — Set your held item in hand as the active road block.
- /block info — View active road block details.
- /block reset — Reset road block to default (Black Concrete).
- /gps help — View navigation help menu.

🐛 Bug Reports & Suggestions
Found a bug or have a great idea for the mod? Please report all issues and suggestions on our GitHub page:
Click here

The discord server:https://discord.gg/VsntDb74NT