WarpPearl

🔮 Warp Pearl

Warp Pearl is a lightweight, vanilla-friendly plugin that introduces an infinite, magical Ender Pearl to your server. It acts as an all-in-one personal waypoint and TPA (Teleport Request) system, all managed through a clean and intuitive graphical user interface (GUI).

Say goodbye to complex commands and hello to an immersive teleportation experience!

---

✨ Features

* 🎵 Immersive Sounds: The Warp Pearl never breaks or gets consumed. * 🎵 Immersive Sounds: Save unlimited locations and teleport back to them anytime through a neat GUI. * 🎵 Immersive Sounds: Send teleport requests to online players using an intuitive menu. * 🎵 Immersive Sounds: The player menu shows the exact distance (in km) between you and other players. * 🎵 Immersive Sounds: Teleport requests appear in chat with interactive `[✓] Accept` and `[✕] Deny` buttons. * 🎵 Immersive Sounds: Server OPs can teleport to players instantly without needing approval. * 🎵 Immersive Sounds: Custom sound effects for opening menus, teleporting, accepting, and denying requests.

---

🛠️ How to Craft

Crafting the Warp Pearl is simple and fits perfectly into vanilla survival. It is a shapeless recipe requiring only two items:

* 1x Compass * 1x Compass

Place them anywhere in a crafting grid, and you will receive a glowing Warp Pearl!

---

📖 How to Use

Simply hold the Warp Pearl in your hand and Right-Click the air or a block to open the Main Menu.

🧭 The Main Menu

1. Player Teleport (Player Head): Click this, then type the name of your new waypoint directly into the chat. Your current location will be saved forever! 2. Player Teleport (Player Head): Opens a sub-menu displaying all your saved locations. Just click on a location's icon to instantly teleport there. 3. Player Teleport (Player Head): Opens a menu showing all currently online players along with their distance from you. Click on a player's head to send them a teleport request.

💬 Accepting/Denying Requests

When someone requests to teleport to you, you will hear a notification sound and see a message in chat. Simply click the green [✕] Deny or the red [✕] Deny directly in the chat to handle the request.

---

⌨️ Commands & Permissions

While the plugin is mostly GUI-based, there are a few handy commands to manage your waypoints:

* `/editwaypoint <old_name> <new_name>` - Rename an existing waypoint. * `/deletewaypoint <name>` - Delete a waypoint.

Permissions: * `warppearl.use` (Default: True) - Allows crafting and using the Warp Pearl. * `warppearl.tpa.bypass` (Default: OP) - Allows admins to instantly teleport to players using the GUI without sending a request.