🛡️ 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:

Throwing an Ender Pearl
Eating a Golden Apple
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 when you aren't trapped
Item Priority
Forces item usage (Ender Pearls, Chorus Fruit, etc.) when clicking inside a trap
100% Client-Side
Works on any server (Vanilla, Paper, Spigot, Fabric)

⚙️ Installation

Download the .jar file
Place it into your mods folder
Launch the game

📋 Requirements

Fabric Loader
Fabric API

🔗 Compatibility

Works on Vanilla servers
Compatible with Sodium, Iris, and most PvP clients

Pearl Out