MarkerNav

MarkerNav — Advanced Waypoint & Navigation System for Minecraft

MarkerNav is a powerful and fully multilingual plugin that allows players to create, manage, and navigate to custom markers (waypoints) in the Minecraft world. Designed for both survival and RPG-style servers, it offers a smooth, interactive GUI system, holograms, teleportation, navigation arrows, and full economy support.

Core Features
✅ Marker Creation

• Create personal or global markers via GUI or command.
  
  
• Custom marker name, category, and expiration time.
  
  
• Markers are stored per-player and persist after restart.
  

Marker Management

• Rename, update location, change category, or set duration.
  
  
• Full in-game GUI support for editing and managing markers.
  
  
• Holograms automatically update to show current marker info.
  

Marker Types

• Personal (only visible to the player)
  
  
• Global (visible to everyone with permission)
  

Navigation System

• Real-time navigation to any marker using compass-like arrows.
  
  
• Action bar updates with direction, distance, and marker name.
  
  
• Configurable format and arrow symbols (N/NE/E etc.)
  
  
• Auto navigation starts after teleport (if enabled).
  

Economy Integration

• Marker creation and teleportation can cost:
  
  • Emeralds (from inventory)
    
    
  • Vault currency (via Vault-compatible economy plugin)
    
• Configurable amounts, currency names, and full localization.
  
  
• Optional permission bypass for free use.
  

✨ GUI Interface

• Fully interactive menus with rich visuals:
  
  • Main Menu
    
    
  • Marker List with filtering & pagination
    
    
  • Type Selector (Personal/Global)
    
    
  • Category Selector (custom icons and names)
    
    
  • Duration Selector
    
    
  • Edit Marker Menu
    
    
  • Teleport & Delete Confirmation
    
    
  • Navigation Control
    

Category System

• Define unlimited marker categories via config.yml.
  
  
• Each category has its own icon and localized name.
  
  
• Used for sorting and visual grouping in menus.
  

Multilingual Support

• English and Russian included by default (lang_en.yml, lang_ru.yml)
  
  
• Auto-detects player’s client language (getLocale())
  
  
• All messages, GUIs, and economy responses are fully localized.
  
  
• Easily extendable to support any language.
  

⚙ Admin & Developer Features

• /mark command with subcommands (create, tp, list, nav, etc.)
  
  
• Permission nodes for:
  
  • Free marker creation
    
    
  • Free teleportation
    
    
  • Global marker access
    
• Plugin logs actions (onEnable/onDisable) with clear status messages.
  
  
• Modular and clean codebase, easily extensible.
  

Dependencies

• Optional: Vault for economy integration (with any Vault-supported plugin)
  
  
• Compatible with Spigot, Paper, Purpur (1.18 – 1.21)
  

Permissions (Examples)
Permission Description
markernav.create.free Allows free marker creation
markernav.tp Allows teleport to personal markers
markernav.tp.free Allows free teleportation
markernav.global Allows creating global markers