🧭 PathFinder GPS - Navigation Plugin for Minecraft

PathFinder GPS is an intuitive navigation plugin that allows you to create destinations and custom visual routes using particles to guide players through your Minecraft world.

✨ Key Features

• 🗺️ Destination Creation - Mark important locations in your world
• 🛤️ Custom Routes - Create visual paths with waypoints
• 🎨 Customizable Particles - Configure colors, types, and density
• 🌍 Multi-World Support - Works across multiple worlds simultaneously
• 🌐 Multi-Language - 5 languages included (EN, ES, PT, FR, IT)
• 🔧 Highly Configurable - Customize every aspect of the plugin
• 🎮 Easy to Use - Intuitive command system
• 🔗 Integration - Compatible with DeluxeMenus, Citizens, ChestCommands, and more

Basic Tutorial

📦 Installation

1. Download the PathFinder.jar file
2. Place it in your server's plugins/ folder
3. Restart the server
4. Done! The plugin is active

Requirements:

• Spigot, Paper, or Purpur server (1.21.8+)
• Java 8 or higher

🚀 Quick Start

Create a Destination

/path set                    # Get the tool (Diamond Shovel)
[Right-click on a block]     # Mark the location
/path create Spawn           # Create the destination

Navigate to a Destination

/path go Spawn              # Navigate to the destination
/path list                  # List all destinations

Create a Custom Route

/path ways create Spawn              # Start waypoint session
[Right-click to mark points]         # Mark waypoints (from start to finish)
/path ways Spawn save north_route    # Save the route

🎯 Navigation Modes

Follow (Follow Route)

/path go Spawn follow

Follows the waypoint route closest to the player.

NoFollow (Straight Line)

/path go Spawn nofollow

Generates a direct straight line ignoring routes.

Mix (Hybrid)

/path go Spawn mix

Straight line to the first waypoint, then follows the route.

Force Specific Route

/path go Spawn follow north_route
/path go Spawn mix south_route

For Other Players

/path go Spawn follow Steve
/path go Spawn mix Alex north_route

🎨 Visual Customization

Change Particles

particles:
  navigation_line_particle: "FLAME"  # Fire effect
  # DUST, FLAME, HEART, VILLAGER_HAPPY, PORTAL, END_ROD, etc.

Custom Colors (DUST only)

colors:
  distance_colors:
    close: [255, 0, 0]        # Bright red
    medium: [255, 165, 0]     # Orange
    far: [0, 255, 0]          # Green
    very_far: [0, 100, 255]   # Blue

🔑 Main Commands

| Command | Description |
|---------|-------------|
| /path set | Get the tool to mark destinations |
| /path create <name> | Create a destination at the marked location |
| /path go <destination> | Navigate to a destination |
| /path list | Show all available destinations |
| /path delete <destination> | Delete a destination and its routes |
| /path ways create <destination> | Start route creation with waypoints |
| /path ways <destination> save <route> | Save the created route |
| /path ways undo | Undo the last waypoint |
| /path reload | Reload the configuration |
| /path lang <language> | Change language (en, es, pt, fr, it) |

Aliases: /path, /pathfinder, /pf

🔐 Permissions

| Permission | Description | Default |
|---------|-------------|---------|
| pathfinder.* | Full access | OP |
| pathfinder.use | Navigate to destinations | Everyone |
| pathfinder.list | View destination list | Everyone |
| pathfinder.set | Get GPS tool | OP |
| pathfinder.create | Create destinations and routes | OP |
| pathfinder.delete | Delete destinations | OP |
| pathfinder.admin | Management and control other players | OP |

🔗 Integration with Other Plugins

PathFinder supports the %player% placeholder for integration:

DeluxeMenus

spawn_button:
  left_click_commands:
    - '[console] path go Spawn follow %player%'

Citizens (NPCs)

/npc command add path go Spawn follow %player%

ChestCommands

spawn-button:
  COMMAND: 'console: path go Spawn follow %player%'

Compatible with: DeluxeMenus, Citizens, ChestCommands, CommandPanels, MyCommand, BossShopPro, and more.

🌐 Available Languages

• 🇺🇸 English (en)
• 🇪🇸 Español (es)
• 🇧🇷 Português (pt)
• 🇫🇷 Français (fr)
• 🇮🇹 Italiano (it)

Change language with /path lang <language> or edit config.yml

💡 Usage Examples

Survival Server

# Create main destinations
/path set
[Click] /path create Spawn
[Click] /path create CommunityShop
[Click] /path create PublicFarm

# Create safe route
/path ways create Spawn
[Mark waypoints]
/path ways Spawn save main_route

Tutorial System with NPCs

# Guide NPC
/npc create Guide
/npc command add path go Spawn follow %player%

Navigation Menu

# DeluxeMenus
spawn:
  material: COMPASS
  left_click_commands:
    - '[console] path go Spawn follow %player%'
    - '[message] &aNavigation activated!'

❓ Frequently Asked Questions

Are routes necessary?
No, destinations work without routes. PathFinder will automatically generate a straight line.

In what direction do I mark waypoints?
From start to finish: From the beginning of the route towards the destination.

How many waypoints can I use?
30 by default, configurable in config.yml (recommended maximum: 100).

Does it work across multiple worlds?
Yes, but you can only navigate to destinations in the same world you're in.

How do I stop navigation?
Navigation stops automatically when reaching the destination, changing worlds, or disconnecting.

📄 License

This project is licensed under the MIT License.

💬 Support

• Full Documentation: GitHub Wiki
• Report Issues: GitHub Issues

Made with ❤️ by GabichiGG