🔮 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

• ♾️ Infinite Uses: The Warp Pearl never breaks or gets consumed.
• 📍 Personal Waypoints: Save unlimited locations and teleport back to them anytime through a neat GUI.
• 🤝 Interactive TPA System: Send teleport requests to online players using an intuitive menu.
• 📏 Distance Calculator: The player menu shows the exact distance (in km) between you and other players.
• 💬 Clickable Chat Prompts: Teleport requests appear in chat with interactive [✓] Accept and [✕] Deny buttons.
• 👑 Admin Bypass: 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 Ender Pearl
• 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. Create New Waypoint (Book): Click this, then type the name of your new waypoint directly into the chat. Your current location will be saved forever!
2. Waypoint List (Compass): 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 [✓] Accept 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.