Перейти к содержимому
Mineforgian

SafePearl

Pearl your way safely through the world.

Загрузки
317
Подписчики
10
Обновлён
26 июня 2026 г.
Лицензия
MIT

Опубликован 4 июня 2025 г.

Исходный кодСообщить об ошибке

SafePearl

Downloads Environment Minecraft

Never die to an ender pearl again.

SafePearl is a lightweight, client-side Fabric mod that shows you exactly where your ender pearl will land — and stops you from throwing one that would get you killed. Works on any server, no server-side install needed.

Features

  • See where your pearl lands
  • Deadly-throw guard
  • Damage prediction
  • Compact HUD

Configuration

  • Mod Menu

Install

  1. Install Fabric Loader and Fabric API.
  2. Drop SafePearl into your mods folder.
  3. (Optional) Add Mod Menu to access the in-game settings.
  • Supports Minecraft 1.21.6 – 1.21.11.

💚 Enjoying SafePearl? Follow the project and leave feedback it genuinely helps more players find the mod.

Ченджлог

2.0+1.21.11Релиз1.21.11 · 26 июня 2026 г.

Changelog

All notable changes to SafePearl are documented here.

[2.0] — Minecraft 1.21.11

A near-complete rewrite. The original prediction was inaccurate and broke in common situations; v2.0 rebuilds it from verified game physics and adds a full safety toolkit.

🎯 Trajectory — now accurate

  • Re-implemented the ender-pearl flight to exactly match Minecraft 1.21.11 physics (verified against the game's own code): correct tick order (gravity → drag → move), spawn at eye-height − 0.1, throw power 1.5.
  • Fixed throwing while moving / falling — the pearl now inherits your velocity, so predictions line up when running, sprinting, or mid-air.
  • Fixed throwing from water — water drag (0.8) vs air drag (0.99) is applied per tick.
  • Added entity collision — predicts when the pearl will strike a mob.

🛡️ Safety assessment

  • Blocks deadly throws — if a throw is predicted to kill you (lethal fall, lava, or the void), SafePearl cancels it client-side before the pearl leaves your hand: no pearl spent, no cooldown. Hold sneak to override, with an optional warning sound. Fully toggleable.
  • Colour-coded verdict: SAFE / RISKY / DEADLY.
  • DEADLY uses your real health + absorption — warns when a throw would actually kill you.
  • Void / abyss throws are correctly flagged DEADLY even when the pearl never hits a block.
  • Lava and the void are treated as certain death.

❤️ Damage prediction — fully modeled

Predicted damage (in hearts) accounts for:

  • The flat 5-damage teleport tax + the vanilla fall-damage formula.
  • Slow Falling, Jump Boost, Resistance status effects.
  • Feather Falling + Protection enchantments on worn armor.
  • Landing surface: water / slime / cobweb / sweet-berry bush / powder snow / scaffolding / ladder (no damage), hay & honey (×0.2), beds (×0.5).
  • Creative / Spectator correctly shows 0 damage.

✨ Visuals

  • Gradient trajectory trail with optional fade and configurable line width.
  • Landing block outline + oriented impact ring on the exact face hit.
  • Landing silhouette box at the precise spot you'll stand, with a drop-line for any fall.
  • Compact HUD readout under the crosshair: status, damage, distance.
  • Entity-hit callout: when the pearl is predicted to strike a mob or player (teleporting you to it rather than where you aimed), the HUD names the target.

⚙️ Configuration

  • In-game Mod Menu settings screen (scrolling — never overflows).
  • All colours editable via palette buttons; toggles, line width, simulation length, and risky / danger fall-distance sliders (the two stay ordered automatically).
  • Reset to defaults button.
  • Toggles for the deadly-throw guard, sneak-override, warning sound, and a "hide HUD when safe" option to keep the crosshair clean.
  • Toggle keybind (unbound by default) with an action-bar notification.
  • Off-hand pearl support; settings persist in config/safepearl.json.

🔧 Technical

  • Minecraft 1.21.11, Fabric Loader 0.19.3, Fabric API 0.141.4+1.21.11, Yarn 1.21.11+build.6, Mod Menu 17.0.0.
  • Toolchain: Fabric Loom 1.17.12, Gradle 9.6.0, Java 21.
  • Performance: one simulation per frame, shared with the HUD; a single entity query over the whole path.
  • Migrated off the deprecated HudRenderCallback to the new HudElement / HudElementRegistry API (drawn right after the crosshair layer) — zero deprecation warnings in the build.
  • Throw guard cancels client-side via UseItemCallback → ActionResult.FAIL (never sends a packet, never spends a pearl). All prediction is wrapped so a fault can never block a throw or crash the world render. Added a bundled LICENSE and fixed a Gradle 9 build break.

📋 Known limitations

  • Pearl camera (picture-in-picture) was investigated but not shipped: 1.21.11's rewritten render pipeline makes a true second-camera view unsafe to build.
  • Damage prediction does not currently model armor points (in vanilla they don't reduce fall or ender-pearl damage anyway) and may slightly over-estimate if enchantments can't be read client-side — it always errs on the safe (higher-damage) side.

[1.0] — Minecraft 1.21

  • Initial release: basic ender-pearl trajectory line and landing-block highlight.
2.0+1.21.6Релиз1.21.6, 1.21.7 · 26 июня 2026 г.

Changelog

All notable changes to SafePearl are documented here.

[2.0] — Minecraft 1.21.11

A near-complete rewrite. The original prediction was inaccurate and broke in common situations; v2.0 rebuilds it from verified game physics and adds a full safety toolkit.

🎯 Trajectory — now accurate

  • Re-implemented the ender-pearl flight to exactly match Minecraft 1.21.11 physics (verified against the game's own code): correct tick order (gravity → drag → move), spawn at eye-height − 0.1, throw power 1.5.
  • Fixed throwing while moving / falling — the pearl now inherits your velocity, so predictions line up when running, sprinting, or mid-air.
  • Fixed throwing from water — water drag (0.8) vs air drag (0.99) is applied per tick.
  • Added entity collision — predicts when the pearl will strike a mob.

🛡️ Safety assessment

  • Blocks deadly throws — if a throw is predicted to kill you (lethal fall, lava, or the void), SafePearl cancels it client-side before the pearl leaves your hand: no pearl spent, no cooldown. Hold sneak to override, with an optional warning sound. Fully toggleable.
  • Colour-coded verdict: SAFE / RISKY / DEADLY.
  • DEADLY uses your real health + absorption — warns when a throw would actually kill you.
  • Void / abyss throws are correctly flagged DEADLY even when the pearl never hits a block.
  • Lava and the void are treated as certain death.

❤️ Damage prediction — fully modeled

Predicted damage (in hearts) accounts for:

  • The flat 5-damage teleport tax + the vanilla fall-damage formula.
  • Slow Falling, Jump Boost, Resistance status effects.
  • Feather Falling + Protection enchantments on worn armor.
  • Landing surface: water / slime / cobweb / sweet-berry bush / powder snow / scaffolding / ladder (no damage), hay & honey (×0.2), beds (×0.5).
  • Creative / Spectator correctly shows 0 damage.

✨ Visuals

  • Gradient trajectory trail with optional fade and configurable line width.
  • Landing block outline + oriented impact ring on the exact face hit.
  • Landing silhouette box at the precise spot you'll stand, with a drop-line for any fall.
  • Compact HUD readout under the crosshair: status, damage, distance.
  • Entity-hit callout: when the pearl is predicted to strike a mob or player (teleporting you to it rather than where you aimed), the HUD names the target.

⚙️ Configuration

  • In-game Mod Menu settings screen (scrolling — never overflows).
  • All colours editable via palette buttons; toggles, line width, simulation length, and risky / danger fall-distance sliders (the two stay ordered automatically).
  • Reset to defaults button.
  • Toggles for the deadly-throw guard, sneak-override, warning sound, and a "hide HUD when safe" option to keep the crosshair clean.
  • Toggle keybind (unbound by default) with an action-bar notification.
  • Off-hand pearl support; settings persist in config/safepearl.json.

🔧 Technical

  • Minecraft 1.21.11, Fabric Loader 0.19.3, Fabric API 0.141.4+1.21.11, Yarn 1.21.11+build.6, Mod Menu 17.0.0.
  • Toolchain: Fabric Loom 1.17.12, Gradle 9.6.0, Java 21.
  • Performance: one simulation per frame, shared with the HUD; a single entity query over the whole path.
  • Migrated off the deprecated HudRenderCallback to the new HudElement / HudElementRegistry API (drawn right after the crosshair layer) — zero deprecation warnings in the build.
  • Throw guard cancels client-side via UseItemCallback → ActionResult.FAIL (never sends a packet, never spends a pearl). All prediction is wrapped so a fault can never block a throw or crash the world render. Added a bundled LICENSE and fixed a Gradle 9 build break.

📋 Known limitations

  • Pearl camera (picture-in-picture) was investigated but not shipped: 1.21.11's rewritten render pipeline makes a true second-camera view unsafe to build.
  • Damage prediction does not currently model armor points (in vanilla they don't reduce fall or ender-pearl damage anyway) and may slightly over-estimate if enchantments can't be read client-side — it always errs on the safe (higher-damage) side.

[1.0] — Minecraft 1.21

  • Initial release: basic ender-pearl trajectory line and landing-block highlight.
2.0+1.21.8Релиз1.21.8 · 26 июня 2026 г.

Changelog

All notable changes to SafePearl are documented here.

[2.0] — Minecraft 1.21.11

A near-complete rewrite. The original prediction was inaccurate and broke in common situations; v2.0 rebuilds it from verified game physics and adds a full safety toolkit.

🎯 Trajectory — now accurate

  • Re-implemented the ender-pearl flight to exactly match Minecraft 1.21.11 physics (verified against the game's own code): correct tick order (gravity → drag → move), spawn at eye-height − 0.1, throw power 1.5.
  • Fixed throwing while moving / falling — the pearl now inherits your velocity, so predictions line up when running, sprinting, or mid-air.
  • Fixed throwing from water — water drag (0.8) vs air drag (0.99) is applied per tick.
  • Added entity collision — predicts when the pearl will strike a mob.

🛡️ Safety assessment

  • Blocks deadly throws — if a throw is predicted to kill you (lethal fall, lava, or the void), SafePearl cancels it client-side before the pearl leaves your hand: no pearl spent, no cooldown. Hold sneak to override, with an optional warning sound. Fully toggleable.
  • Colour-coded verdict: SAFE / RISKY / DEADLY.
  • DEADLY uses your real health + absorption — warns when a throw would actually kill you.
  • Void / abyss throws are correctly flagged DEADLY even when the pearl never hits a block.
  • Lava and the void are treated as certain death.

❤️ Damage prediction — fully modeled

Predicted damage (in hearts) accounts for:

  • The flat 5-damage teleport tax + the vanilla fall-damage formula.
  • Slow Falling, Jump Boost, Resistance status effects.
  • Feather Falling + Protection enchantments on worn armor.
  • Landing surface: water / slime / cobweb / sweet-berry bush / powder snow / scaffolding / ladder (no damage), hay & honey (×0.2), beds (×0.5).
  • Creative / Spectator correctly shows 0 damage.

✨ Visuals

  • Gradient trajectory trail with optional fade and configurable line width.
  • Landing block outline + oriented impact ring on the exact face hit.
  • Landing silhouette box at the precise spot you'll stand, with a drop-line for any fall.
  • Compact HUD readout under the crosshair: status, damage, distance.
  • Entity-hit callout: when the pearl is predicted to strike a mob or player (teleporting you to it rather than where you aimed), the HUD names the target.

⚙️ Configuration

  • In-game Mod Menu settings screen (scrolling — never overflows).
  • All colours editable via palette buttons; toggles, line width, simulation length, and risky / danger fall-distance sliders (the two stay ordered automatically).
  • Reset to defaults button.
  • Toggles for the deadly-throw guard, sneak-override, warning sound, and a "hide HUD when safe" option to keep the crosshair clean.
  • Toggle keybind (unbound by default) with an action-bar notification.
  • Off-hand pearl support; settings persist in config/safepearl.json.

🔧 Technical

  • Minecraft 1.21.11, Fabric Loader 0.19.3, Fabric API 0.141.4+1.21.11, Yarn 1.21.11+build.6, Mod Menu 17.0.0.
  • Toolchain: Fabric Loom 1.17.12, Gradle 9.6.0, Java 21.
  • Performance: one simulation per frame, shared with the HUD; a single entity query over the whole path.
  • Migrated off the deprecated HudRenderCallback to the new HudElement / HudElementRegistry API (drawn right after the crosshair layer) — zero deprecation warnings in the build.
  • Throw guard cancels client-side via UseItemCallback → ActionResult.FAIL (never sends a packet, never spends a pearl). All prediction is wrapped so a fault can never block a throw or crash the world render. Added a bundled LICENSE and fixed a Gradle 9 build break.

📋 Known limitations

  • Pearl camera (picture-in-picture) was investigated but not shipped: 1.21.11's rewritten render pipeline makes a true second-camera view unsafe to build.
  • Damage prediction does not currently model armor points (in vanilla they don't reduce fall or ender-pearl damage anyway) and may slightly over-estimate if enchantments can't be read client-side — it always errs on the safe (higher-damage) side.

[1.0] — Minecraft 1.21

  • Initial release: basic ender-pearl trajectory line and landing-block highlight.
2.0+1.21.10Релиз1.21.10 · 26 июня 2026 г.

Changelog

All notable changes to SafePearl are documented here.

[2.0] — Minecraft 1.21.11

A near-complete rewrite. The original prediction was inaccurate and broke in common situations; v2.0 rebuilds it from verified game physics and adds a full safety toolkit.

🎯 Trajectory — now accurate

  • Re-implemented the ender-pearl flight to exactly match Minecraft 1.21.11 physics (verified against the game's own code): correct tick order (gravity → drag → move), spawn at eye-height − 0.1, throw power 1.5.
  • Fixed throwing while moving / falling — the pearl now inherits your velocity, so predictions line up when running, sprinting, or mid-air.
  • Fixed throwing from water — water drag (0.8) vs air drag (0.99) is applied per tick.
  • Added entity collision — predicts when the pearl will strike a mob.

🛡️ Safety assessment

  • Blocks deadly throws — if a throw is predicted to kill you (lethal fall, lava, or the void), SafePearl cancels it client-side before the pearl leaves your hand: no pearl spent, no cooldown. Hold sneak to override, with an optional warning sound. Fully toggleable.
  • Colour-coded verdict: SAFE / RISKY / DEADLY.
  • DEADLY uses your real health + absorption — warns when a throw would actually kill you.
  • Void / abyss throws are correctly flagged DEADLY even when the pearl never hits a block.
  • Lava and the void are treated as certain death.

❤️ Damage prediction — fully modeled

Predicted damage (in hearts) accounts for:

  • The flat 5-damage teleport tax + the vanilla fall-damage formula.
  • Slow Falling, Jump Boost, Resistance status effects.
  • Feather Falling + Protection enchantments on worn armor.
  • Landing surface: water / slime / cobweb / sweet-berry bush / powder snow / scaffolding / ladder (no damage), hay & honey (×0.2), beds (×0.5).
  • Creative / Spectator correctly shows 0 damage.

✨ Visuals

  • Gradient trajectory trail with optional fade and configurable line width.
  • Landing block outline + oriented impact ring on the exact face hit.
  • Landing silhouette box at the precise spot you'll stand, with a drop-line for any fall.
  • Compact HUD readout under the crosshair: status, damage, distance.
  • Entity-hit callout: when the pearl is predicted to strike a mob or player (teleporting you to it rather than where you aimed), the HUD names the target.

⚙️ Configuration

  • In-game Mod Menu settings screen (scrolling — never overflows).
  • All colours editable via palette buttons; toggles, line width, simulation length, and risky / danger fall-distance sliders (the two stay ordered automatically).
  • Reset to defaults button.
  • Toggles for the deadly-throw guard, sneak-override, warning sound, and a "hide HUD when safe" option to keep the crosshair clean.
  • Toggle keybind (unbound by default) with an action-bar notification.
  • Off-hand pearl support; settings persist in config/safepearl.json.

🔧 Technical

  • Minecraft 1.21.11, Fabric Loader 0.19.3, Fabric API 0.141.4+1.21.11, Yarn 1.21.11+build.6, Mod Menu 17.0.0.
  • Toolchain: Fabric Loom 1.17.12, Gradle 9.6.0, Java 21.
  • Performance: one simulation per frame, shared with the HUD; a single entity query over the whole path.
  • Migrated off the deprecated HudRenderCallback to the new HudElement / HudElementRegistry API (drawn right after the crosshair layer) — zero deprecation warnings in the build.
  • Throw guard cancels client-side via UseItemCallback → ActionResult.FAIL (never sends a packet, never spends a pearl). All prediction is wrapped so a fault can never block a throw or crash the world render. Added a bundled LICENSE and fixed a Gradle 9 build break.

📋 Known limitations

  • Pearl camera (picture-in-picture) was investigated but not shipped: 1.21.11's rewritten render pipeline makes a true second-camera view unsafe to build.
  • Damage prediction does not currently model armor points (in vanilla they don't reduce fall or ender-pearl damage anyway) and may slightly over-estimate if enchantments can't be read client-side — it always errs on the safe (higher-damage) side.

[1.0] — Minecraft 1.21

  • Initial release: basic ender-pearl trajectory line and landing-block highlight.

Комментарии

Загружаем…