Navigator

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
• Visual Waypoints
• Fully customizable Command-Permissions

Requirements

• Java 21+
• 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