Navigate

A Minecraft plugin that provides intelligent pathfinding and real-time navigation assistance to help players reach their destinations - reliably, efficiently, and over any distance.

✨ Features

• Smart Pathfinding - Uses an optimized A* algorithm to find efficient paths around obstacles
• Baritone-Style Long Distance Pathing - Navigates as far as possible in loaded chunks, recalculates when new chunks load, and continues until the destination is reached
• Visual Guidance - Displays particle trails showing exactly where to walk
• Safe Mode - Optional fall protection to prevent dangerous drops
• Allowed Materials - Restrict navigation to specific block types (roads, paths, custom maps, etc.)
• Smart Terrain Handling - Uses climbables like ladders and vines. Without safeMode it may even perform parkour
• Force Navigate - Admins can start or stop navigation for other players
• PAPI Support - Built-in PlaceholderAPI placeholders for full scoreboard / UI integration
• Performance Optimized - Asynchronous pathfinding to prevent server lag
• Customizable Directions - Fully configurable direction strings

🧩 PlaceholderAPI

Available placeholders:

• %navigate_direction%
• %navigate_yaw%
• %navigate_pitch%
• %navigate_distance2d%
• %navigate_distance3d%
• %navigate_x%
• %navigate_y%
• %navigate_z%
• %navigate_world%

Perfect for scoreboards, action bars, holograms, and custom HUD systems.

📋 Commands

• /navigate start <x> <y> <z> [safeMode] [allowedMaterials] - Begin navigation to specified coordinates
• /navigate stop - Cancel current navigation
• /navigate startfor <player> <x> <y> <z> [safeMode] [allowedMaterials] - Start navigation for another player
• /navigate stopfor <player> - Stop navigation for another player
• /navigate neofetch - Display plugin information in a fun system-style format

Example:

/navigate start 100 64 -250 true stone,dirt

• true enables safeMode
• stone,dirt restricts pathing to Stone or Dirt

🔒 Permissions

• navigate.use - Allows using basic navigation commands
• navigate.use.others - Allows navigating other players
• navigate.use.neofetch - Allows using the neofetch command

⚙️ How It Works

1. Player specifies target coordinates

2. Plugin calculates path using advanced A* algorithm

   • Handles complex terrain and obstacles
   • Respects safeMode for fall prevention
   • Supports material-restricted routing

3. Displays a colored particle trail

4. Continuously recalculates when new chunks load

5. Stops automatically once the destination is reached

This allows extremely long-distance navigation without freezing or failing due to unloaded terrain.

⚙️ Configuration

strings:
  direction:
    south: "South"
    south-west: "South-West"
    west: "West"
    north-west: "North-West"
    north: "North"
    north-east: "North-East"
    east: "East"
    south-east: "South-East"
    unknown: "N/A"

🟩 Showcase

🏗️ Technical Details

• Asynchronous Processing - Pathfinding runs off the main thread
• Iteration Improvements - Increased search attempts before cancelling
• Chunk-Aware Pathing - Calculates within loaded chunks and extends dynamically
• Efficient Memory Management - Cleans up active navigations automatically

Perfect for adventure maps, survival servers, RPG worlds, large open maps, or any gameplay where intelligent navigation assistance enhances the player experience.