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 * **♾️ 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 ` - Rename an existing waypoint. * `/deletewaypoint ` - 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.