Ever thrown an ender pearl in a PvP fight and lost track of it in the middle of all the particles and screen shake? That's basically why this mod exists.
TruePearls is a small client-side Fabric mod that changes how thrown ender pearls look based on who threw them. Your own pearls get one look, everyone else's get another - so at a glance, mid-fight, you always know which pearl is yours without squinting at the trajectory.
It started as a personal fix for my own PvP Sessions and PvP Experience, and it grew a proper config screen along the way, so now anyone can tune it to taste..
✨ Features
- Per-thrower pearl textures : your thrown pearls and other players' thrown pearls can look different. No more guessing whose pearl just flew past your head.
- Three pearl modes, switchable anytime from the config screen:
- Your Pearl = Vanilla, Opponent = Animated : your own pearl stays 100% untouched vanilla, everyone else's shows the animated custom look.
- Your Pearl = Animated, Opponent = Simple (default) : your pearl gets the animated custom texture, opponents get the simpler look.
- Your Pearl = Simple, Opponent = Animated : the reverse of the default, if that's more your style.
- Invisible Own Pearl : makes your own thrown pearl invisible to you specifically. Other players still see it fine. Useful if you find your own pearl distracting mid-clutch.
- Pearl trail particles : an optional faint particle trail behind flying pearls, purely cosmetic, off by default.
- Pearl scale slider : resize the thrown pearl icon from 0.25x up to 3x, in case you want it more (or less) in-your-face.
- Full config screen through ModMenu + Cloth Config - every option above is a toggle, dropdown, or slider, no config file editing needed.
Everything here is purely visual. No gameplay values change, no hitboxes move, nothing that would raise an eyebrow on a server that checks for that sort of thing- it's reskinning, not cheating.
It's 100% client-side. You don't need it installed on a server, and installing it doesn't affect anyone who doesn't have it.
📋 Requirements
<details>
<summary>Requirements</summary>
| Dependency |
Version |
| Minecraft |
1.21.11 |
| Fabric Loader |
0.16.10+ |
| Fabric API |
Latest for 1.21.11 |
| Cloth Config API |
21.11.153+ |
| Java |
21+ |
ModMenu is optional but recommended - without it, the config still works, you'd just be editing config/truepearls.json by hand instead of clicking through a screen.
</details>
📥 Installation
<details>
<summary>Installation</summary>
- Grab Fabric Loader and Fabric API for 1.21.11 if you don't already have them.
- Drop
truepearls-1.0.0.jar into your .minecraft/mods or profileVersion/mods folder.
- Grab and add Cloth Config API (required) and ModMenu (optional, but you'll want it).
- Launch the game. That's it - no world reset, no config setup needed to get started.
</details>
🎛️ Configuring it
<details>
<summary>Configure</summary>
Open ModMenu → find TruePearls → click the config icon. Every setting takes effect immediately, no restart needed. If you'd rather not use ModMenu, the same settings live in plain JSON at .minecraft/config/truepearls.json.
</details>
⚠️ A couple of honest limitations
- This mod only changes ender pearls specifically - it doesnt touch eggs, snowballs, or splash potions, even though they're rendered by a similar system under the hood.
- The trail particle option is a purely cosmetic addition on my part : vanilla ender pearls never had a flight trail to begin with, so this isn't "restoring" anything, it's new.
- Since this is client-side only, on a server where other players don't have the mod, you'll still see their default pearl. The magic only works between players who both have TruePearls installed.
📜 License
This project is licensed under the
Creative Commons Attribution-NonCommercial-NoDerivatives 4.0 International
(CC BY-NC-ND 4.0)
https://creativecommons.org/licenses/by-nc-nd/4.0/
Contact
Email
📩 iyash321@gmail.com
Support us
☕ Buy Me a Coffee
Made with ❤️ by Yashh-Penchi ˖ ࣪⊹ — Yashh Labs ๋࣭⭑
