PearlKeeper

PearlKeeper

A lightweight Paper plugin that ensures ender pearls survive everything — logouts, deaths, and server restarts. Built specifically to patch AuthMe's broken pearl handling, but works as a standalone solution on any Paper server.

The Problem

On cracked/offline servers using AuthMe, ender pearls in stasis chambers get destroyed when players log off. AuthMe's built-in recreateEnderPearls option attempts to fix this but frequently fails with "Failed to spawn player ender pearl" errors when the chunk isn't loaded.

This breaks stasis chamber-based mechanisms entirely.

What PearlKeeper Does

• On logout — saves all your active pearls to disk and removes the live entities
• On login — waits for AuthMe to finish authentication, then respawns pearls exactly where they were with their original velocity
• On death — intercepts pearls before vanilla Minecraft deletes them, restores them on respawn
• On server restart — pearls persist across full server shutdowns
• Force-loads chunks before respawning to prevent the "skipping" errors

Setup

1. Drop the jar into plugins/
2. Restart your server
3. (Recommended) Set recreateEnderPearls: false in your AuthMe config to prevent pearl duplication.

No commands, no permissions, no configuration needed.