REST Pearl Catch

REST Pearl Catch makes Ender Pearl and Wind Charge catches more consistent on Paper-compatible Minecraft 1.21 servers.

Instead of changing the normal projectile mechanics globally, it tracks thrown Ender Pearls and Wind Charges and applies configurable catch detection so close catches feel more reliable and forgiving.

Features

• Supports Ender Pearls and Wind Charges.
• Configurable catch hitbox size.
• Configurable minimum projectile age to avoid useless instant face-catches immediately after throwing.
• Optional overlap counting for more vanilla-like or more forgiving behavior.
• Configurable projectile tracking timeout.
• Per-world disabling through disabled-worlds.
• Lightweight tick-based projectile tracking.
• Debug mode available in config.yml.

Default configuration

hitbox: 0.80
min-age-ticks: 5
count-overlap: false
max-track-ticks: 60
disabled-worlds: []
debug: false

Hitbox guidance

• 0.60 is closer to a conservative / vanilla-like assisted catch.
• 0.80 is the recommended balance for easier, consistent catches.
• 1.00+ is very forgiving and can noticeably change catch height or timing.

Compatibility

Designed for Paper / Leaf compatible Minecraft 1.21.x servers, with the plugin built against the 1.21 API.

REST Pearl Catch is intended for PvP, Practice, SMP, Lifesteal, event, and network servers where reliable pearl and wind-charge catching matters.