Pull My Pearl

Pull My Pearl 🔮

Pull My Pearl is a lightweight, 100% client-side Fabric mod built for players using Ender Pearl stasis chambers on multiplayer servers (SMPs, DonutSMP, PvP networks, etc.).

▶️ Click Here To Listen Alarm🚨

No server-side plugins or server mods required! When you are in danger, simply press your designated key to trigger an immediate, high-priority visual HUD notification and audio alarm on your teammate's screen so they can pull your pearl without delay.

[!IMPORTANT]

⚠️ How It Works & Crucial Server / Chat Settings

• Communication Mechanism: This mod operates entirely client-side by sending encrypted background direct messages (/msg) between you and your teammate. The mod automatically hides these raw packets from your chatbox so your chat remains completely clean.
• 🌐 Cross-Server Network Support: Because alerts use the server's native whisper system (/msg), it supports cross-subserver networks (e.g. DonutSMP Europe & Asia realms, BungeeCord, Velocity). As long as the server allows private messaging across subservers, the alarm will reach your teammate even if you are on completely different realms or dimensions!
• Direct Messages Must Be Allowed: Both players must be able to receive whispers from each other. If your target server has privacy settings (e.g. /settings or /msg toggle), make sure "Who can message me" is set to Everyone or Friends/Party.
• Chat Must Be Shown: Ensure your in-game chat visibility is enabled in Options -> Chat Settings -> Chat: Shown. If whispers are blocked or filtered out by server privacy toggles, alarms will not be received!

[!WARNING]

⌨️ Keybind Conflict Warning

If the Pearl Pull Key is bound to the same key as another mod or Minecraft control, key registration may fail due to conflicts! Please ensure you assign it to an unused / conflict-free key in Options -> Controls -> Key Binds or directly through the in-game Pull My Pearl settings menu (Right Shift).

✨ Features

• 100% Client-Side: Works out of the box on any vanilla or modded Minecraft server.
• 🌐 Cross-Server / Subserver Compatible: Works across proxy networks (like DonutSMP sub-realms) as long as /msg functions across servers.
• Visual Alert Card: Displays an animated on-screen HUD card with pulsing borders and a real-time countdown timer.
• Audio Alarm: Plays distinct high-pitched note block alerts so your teammate notices instantly even when tabbed out.
• Spam Protection: Built-in 5-second cooldown to prevent accidental message flooding.
• ModMenu Integration: Easily adjust volume, toggle sound, or rebind keys directly in-game or via the ModMenu config screen.

🎮 Commands

Use the /pteam command to manage your stasis partner:

• /pteam invite <player> — Sends a team invite to the specified player.
• /pteam accept [player] — Accepts an incoming team invite.
• /pteam leave — Leaves your current team.
• /pteam status — Checks your current team connection status.

🕹️ Controls (Default)

• Send Pearl Alarm: P (Configurable in settings)
• Open Settings GUI: Right Shift

📦 Requirements

• Minecraft: 1.21.x / 26.x
• Fabric Loader: 0.16.0 or newer
• Fabric API
• ModMenu (Optional, for in-game settings GUI)