🛡️ PearlOut

An essential Client-Side QoL mod for PvP and Anarchy players to effortlessly escape annoying Sign & Armor Stand traps!

⚠️ WARNING: Use at your own risk!
While this mod fixes annoying vanilla interaction mechanics, altering how your client interacts with blocks and entities can be considered an unfair advantage or cheat by some server anti-cheats and server rules. Depending on the server you play on, using this modification can lead to a ban. Always check the rules of the server before using it!

🛑 The Problem

If you play PvP, Factions, or Anarchy servers, you've probably been trapped in a small space filled with Signs or Armor Stands. Normal Minecraft mechanics make it incredibly frustrating to escape: Instead of throwing your Ender Pearl or drinking a potion, your clicks are absorbed by the Armor Stands or you accidentally open the Sign-Editing GUI instead. You are stuck and basically dead.

✅ The Solution

PearlOut fixes this completely on the client-side!

The mod intelligently detects when your character is stuck in a trap-like situation (standing exactly inside signs at your feet/head, or intersecting with an Armor Stand). When this happens, it automatically ignores block and entity interactions for Signs and Armor Stands.

Instead of opening a GUI or hitting an Armor Stand, your right-click will bypass them entirely and seamlessly use the item in your main hand (e.g., throwing an Ender Pearl, eating a Golden Apple, or drinking a Potion).

✨ Features

• Smart Detection: Only activates when you are actually trapped (intersecting an Armor Stand or standing inside Signs).
• Zero Disruption: Normal sign interactions and armor stand usage work perfectly fine 100% of the time when you aren't trapped!
• Item Priority: Forces item usage (Ender Pearls, Chorus Fruit) when clicking inside a trap.
• 100% Client-Side: You only need to install this on your client. It works on ANY Server (Vanilla, Paper, Spigot, Fabric).

⚙️ Installation

Just drop the .jar into your mods folder.

• Requirements: Fabric Loader & Fabric API
• Compatibility: Works on Vanilla Servers, works flawlessly alongside performance mods like Sodium/Iris and typical PVP-Clients.