Navigator

Navigator is a Paper/Spigot plugin for managing shared teleportation points through commands and a custom Navigator GUI.

The plugin supports:

• - Global teleportation points and groups
• - A Navigator item (custom Nether Star) that opens a multi-level GUI on right-click
• - In-GUI delete of TP points and groups with click-to-confirm chat prompts
• - Player-to-player teleport requests with clickable confirmation
• - Fully customizable Command-Permissions

Requirements

- Java 21+
- Minecraft 1.20.2 - 1.21.11
- Paper / Spigot server using at least Paper/Spigot API 1.20.2

Installation

1. Download Navigator.
2. Drop it into your server's `plugins/` folder.
3. Start or restart the server.

Main Features

1. Shared TP points

Teleport points are stored globally in `config.yml`, not per-player.

Each TP point stores: world, x, y, z, yaw, pitch, and an optional group name.

2. Group support

TP points can be assigned to groups. Groups are browsed through the Navigator GUI.

3. Navigator item

The Navigator is a custom Nether Star identified by Persistent Data Container data — only the plugin-created item opens the menu.

Give it to yourself with `/navigator item` or to another player with `/navigator item <PlayerName>`.

4. Player-to-player teleport requests

Admins can teleport one player to another.

- If the sender is teleporting *another* player, that player receives a clickable `[Y]` / `[N]` confirmation.
- If the sender is teleporting *themselves*, approval is skipped.
- Use `-f` to force the teleport immediately without confirmation.

5. Confirmation safety

Delete operations (`/navigator remove`, `/navigator remove group`, in-GUI deletes) require a click-to-confirm step using bold, clickable `[Y]` and `[N]` chat buttons. Only the first click is processed — subsequent clicks are silently ignored.

Quick Start

/navigator set group city
/navigator set spawn city
/navigator set market city
/navigator set mine
/navigator

- Opens the GUI → click **Groups** → click **city** → see `spawn` and `market`
- The ungrouped `mine` point is accessible from the group list as well