BetterStasis

A Minecraft plugin for Paper 1.21+ that implements a pearl stasis chamber system.

https://youtube.com/shorts/u7McqpqFfG0?feature=share

Features

• Bind ender pearls to fishing rods - Shift + Right-Click with a fishing rod to bind the closest ender pearl
• Teleport on demand - Right-Click (reel) the bound rod to teleport to the pearl location
• Server-friendly - Pearl entities disappear when bound, no performance impact
• Reusable - Rods don't break, take damage, or have cooldowns
• No damage - Teleporting doesn't hurt the player
• No permissions - Everyone can use the feature by default

Installation

1. Download BetterStasis-1.0.0.jar from Releases
2. Place the jar in your server's plugins/ folder
3. Restart or reload your server
4. Configure settings in plugins/PearlStasis/config.yml (optional)

How to Use

1. Throw an ender pearl somewhere you want to teleport to later
2. Shift + Right-Click with a fishing rod to bind the pearl
   • The rod will glow and show coordinates in the lore
   • The pearl entity will disappear
3. Right-Click (reel) the bound rod anytime to teleport to that location
   • The binding is cleared after teleporting
   • The rod can be bound to a new pearl

Configuration

Edit plugins/PearlStasis/config.yml:

settings:
  search-radius: 8.0          # Max distance to find pearls when binding
  min-pearl-distance: 2.0     # Min distance to prevent instant pickup

  feedback:
    particles: true           # Show particle effects
    sounds: true              # Play sound effects
    messages: true            # Send chat messages

  teleport:
    check-safe-location: true      # Verify destination is safe
    prevent-suffocation: true      # Don't teleport into solid blocks
    cancel-if-unsafe: true         # Cancel unsafe teleports

Technical Details

• Platform: Paper 1.21+
• Java: 21
• Storage: PersistentDataContainer (survives server restarts, item drops, chest storage)
• Performance: Event-driven, no ticking tasks, minimal overhead
• Compatibility: Works across all 1.21.x versions

Support

Report issues at: https://discord.gg/CUQdkPzGKb