# MarkerNav Plugin

**MarkerNav** is a fully-featured multilingual waypoint and navigation plugin for Minecraft servers. Players can create personal or global markers, navigate to them in real-time, teleport, and manage all markers via a clean, intuitive GUI.

---

## ✨ Features

### Marker Management
- Create personal or global markers.
- Interactive GUI with pagination and filtering.
- Categories with custom icons and localized names.
- Rename, edit, or delete markers at any time.
- Expiration system: set marker duration (temporary or permanent).

### Navigation System
- Compass-like real-time navigation.
- Configurable direction arrows in action bar.
- Automatically starts after teleport (optional).
- Distance display with unit (`m`, `blocks`, etc.).

### Economy Support
- Optional cost for creating or teleporting to markers.
- Supports:
- Vault-based economy
- Emerald-based cost
- Full message and currency name customization.
- Permissions to bypass costs.

### Localization
- Auto-detects player language (`en_US`, `ru_RU`, etc.).
- Full support for multiple languages (`lang_en.yml`, `lang_ru.yml`).
- Every message, tooltip, GUI title is configurable and translatable.

### GUI Menus
- Main menu
- Marker list (pagination & filter: personal/global)
- Type selector (personal/global)
- Category selector (icon + name)
- Duration selector (custom expiry)
- Teleport confirmation
- Delete confirmation
- Marker editor (rename, update location, etc.)

---

## Configuration

```yaml
update-interval-seconds: 5

navigator:
unit: "m"
format: "{arrow} {dist}{unit} to {name}"
arrows-8:
N: "▲"
NE: "↗"
E: "▶"
SE: "↘"
S: "▼"
SW: "↙"
W: "◀"
NW: "↖"

marker-create:
enabled: true
cost:
type: "VAULT" # or "EMERALD"
amount: 30
vault:
currency-name: "coins"

teleport:
enabled: true
cost:
type: "EMERALD"
amount: 5

categories:
home:
icon: "RED_BED"
display: "categories.home.display" # Taken from lang files
dungeon:
icon: "MOSSY_COBBLESTONE"
display: "categories.dungeon.display"
Permissions

Node Description
markernav.create.free Free marker creation
markernav.tp Allow teleport to marker
markernav.tp.free Free teleportation
markernav.global Create global markers
markernav.* Admin access to all features
Dependencies
Vault (only if using VAULT economy)

Compatible with: Spigot, Paper, Purpur (1.18+)

Installation
Drop MarkerNav.jar into your /plugins folder.

Start the server.

Edit config.yml and lang_*.yml as needed.

Reload or restart server.

Commands

Command Description
/mark create <name> Create a new marker
/mark list List your markers
/mark tp <name> Teleport to a marker
`/mark nav <start stop> <name>`
/mark gui Open main GUI
/mark help Show help
Multilingual Support
Automatically detects player language via Player#getLocale().

Supports fallback to English.

All texts from GUI, messages, tooltips are translatable via lang_en.yml, lang_ru.yml, etc.