🔮 Warp Pearl

One infinite Ender Pearl. Personal waypoints, player teleport requests, all from a simple menu.

Warp Pearl adds a single craftable item to your server that replaces long lists of /home and /tpa commands. Right-click it, pick where you want to go, and you're there. It feels like vanilla, needs no setup and works out of the box.

---

✨ Features

• ♾️ Infinite pearl: it is never consumed and never breaks.
• 📍 Personal waypoints: save your current position with a name and teleport back to it from the menu (up to 54 per player).
• 🤝 Teleport requests: pick an online player from the menu to send a request. They accept or deny with clickable buttons in chat.
• 📏 Distance display: every player in the menu shows how far away they are, or if they are in another world.
• 👑 Admin bypass: OPs can teleport to players instantly, without a request.
• 🌍 4 languages: English, Italian, German and Russian, selectable in config.yml. All texts are editable in messages.yml.
• 🎵 Sound effects for menus, teleports and requests.

---

🛠️ Crafting

!Warp Pearl crafting

Shapeless recipe, put the items anywhere in the crafting grid:

• 1x Ender Pearl
• 1x Compass

---

📖 How to use

Hold the Warp Pearl and right-click to open the main menu:

Button	What it does
📕 Create New Waypoint	Type a name in chat to save your current location.
🧭 Waypoint List	Click a waypoint to teleport there.
👤 Player Teleport	Click a player's head to send a teleport request.

When someone asks to teleport to you, a sound plays and two buttons appear in chat: [✓] Accept and [✕] Deny.

---

⌨️ Commands

Command	Description
/editwaypoint <old> <new>	Rename a waypoint (with tab completion)
/deletewaypoint <name>	Delete a waypoint

🔑 Permissions

Permission	Default	Description
warppearl.use	everyone	Craft and use the Warp Pearl
warppearl.tpa.bypass	OP	Teleport to players without a request

---

⚙️ Installation

1. Download the .jar and put it in your server's plugins folder.
2. Restart the server.
3. Optional: change the language in plugins/WarpPearl/config.yml (en, it, de, ru).

Works on Paper, Purpur and Spigot. No dependencies needed.

---

💬 Found a bug or have an idea? Let me know, feedback is always welcome!