🧩 EnderPearlPatch

A plugin that prevents Ender Pearls from disappearing when players log out or die.
It stores all active pearls and restores them after the player rejoins or respawns — even on servers using AuthMe or similar login systems that temporarily remove players from the world.

---

📝 Description

This plugin fixes a common issue where Ender Pearls vanish when a player logs out or dies — especially on servers using AuthMe or similar login systems, where players are temporarily removed from the world.
Instead of letting pearls disappear, this plugin saves them and restores them after the player logs back in or respawns.
It also provides useful admin commands to list, delete, add, and create saved pearls manually.

---

⚙️ Features

• Prevents ender pearls from vanishing on logout or death
• Restores pearls with correct location and velocity after login or respawn
• Compatible with AuthMe and other login-delay plugins
• /pearls list, add, del, create commands for full pearl management
• Configurable behavior through config.yml
• Only accessible by OPs (or players with enderpearlpatch.admin permission)

---

📂 Configuration (config.yml)

enabled: true
respawn-mode: login_and_respawn

🔧 Parameters

Key	Type	Default	Description
enabled	boolean	true	Enables or disables the plugin entirely. If set to false, all listeners and restoration logic are disabled.
respawn-mode	string	login_and_respawn	Defines when pearls should be restored: • login → only when the player logs in • login_and_respawn → when logging in and after respawning

---

🧭 Commands Overview

These commands are available to OPs or players with the enderpearlpatch.admin permission.

🔄 /enderpearlpatch reload

Reloads the plugin and configuration.
All data and settings are refreshed from disk.

Permission: enderpearlpatch.admin

---

⚙️ /enderpearlpatch mode <login|login_and_respawn>

Changes the pearl restoration mode directly from in-game.
Updates config.yml and applies changes immediately.

Examples:

/enderpearlpatch mode login
/enderpearlpatch mode login_and_respawn

Permission: enderpearlpatch.admin

---

💠 /pearls Subcommands

📋 /pearls list

Lists all currently saved ender pearls for all players, showing their world and coordinates.

Example Output:

Player: JanekDev
  #0 → world 123 64 456
  #1 → world_nether -23 70 40

---

❌ /pearls del <player> <id>

Deletes a specific saved pearl by its index (id) from the specified player's list.

Example:

/pearls del JanekDev 0

Output:

§aPearl #0 deleted for JanekDev

---

➕ /pearls add <player> <x> <y> <z> <world> [vx vy vz]

Adds a saved pearl for a player at the specified coordinates, with optional velocity.
It will be restored automatically when the player rejoins.

Example:

/pearls add JanekDev 100.5 64 200 world 0 0.5 0

→ Adds a pearl at (100.5, 64, 200) in world with slight upward velocity.

---

✨ /pearls create <player> <x> <y> <z> <world> [vx vy vz]

Immediately spawns a live Ender Pearl in the world for the specified player.

Example:

/pearls create JanekDev 50 70 50 world 1 0 0

→ Spawns a pearl moving east at (50, 70, 50) for JanekDev.

---

🧰 Permissions

Permission	Default	Description
enderpearlpatch.admin	op	Allows use of /enderpearlpatch and /pearls commands

---

👤 Author

JanekDev — Developer