Essential Patcher

Download on CurseForge

Essential Patcher is a client-side Minecraft mod that patches the Essential mod at runtime.

It is built for users who want more control over Essential's cosmetics, telemetry, ads, purchase prompts, and client-side behavior.

• Unlocks cosmetics locally on your client.
• Saves your equipped cosmetics locally.
• Syncs cosmetics with other Essential Patcher users through an independent HTTPS sync service.
• Blocks Essential telemetry and analytics calls.
• Removes ads, promos, notices, purchase prompts, and checkout flows.
• Fixes some Essential cosmetic sync crashes.
• Keeps the patcher separate from Essential's servers and account entitlements.

Essential Patcher uses Mixins to change Essential while Minecraft is running.

The mod does not edit Essential's JAR. It loads alongside Essential, intercepts selected client-side methods, and changes the result locally.

For cosmetics, the patcher stores your selected cosmetic IDs and settings, sends them to the patcher sync service, and receives cosmetic data from other patcher users in the same session. Only users running Essential Patcher can see this synced cosmetic data.

For privacy, the patcher blocks known telemetry, analytics, and tracking paths before they leave the client.

For ads and purchases, the patcher removes or blocks local UI and packet paths related to promos, coin purchases, checkout, and shop prompts.

• It does not include Essential's code.
• It does not include Essential's assets, cosmetics, models, textures, or icons.
• It does not include Minecraft's code or assets.
• It does not distribute a modified Essential JAR.
• It does not distribute a modified Minecraft JAR.
• It does not create Coins.
• It does not submit fake purchases.
• It does not modify Essential account ownership records.
• It does not make non-patcher users see patched cosmetics.

Essential Patcher runs an independent cosmetic sync service at cosmetics.leclowndu93150.dev so patcher users can see each other's cosmetics. Here is exactly what is stored and what is not.

• No IP addresses are logged or stored.
• No Minecraft access tokens or session tokens are stored. The Mojang session auth is a one-time handshake to verify you own the account; the token is never saved.
• No email addresses, passwords, or account credentials.
• No playtime, server history, or gameplay data.
• No chat messages, friend lists, or social data.
• No hardware info, OS info, or device fingerprints.
• No analytics, telemetry, or tracking of any kind.

1. The client requests a challenge (random server ID) from the sync server.
2. The client calls Mojang's joinServer with that challenge to prove account ownership.
3. The sync server calls Mojang's hasJoined to verify.
4. On success, the server issues a short-lived JWT containing only your UUID. No Mojang tokens are retained.

All player data is automatically deleted after 90 days of inactivity. To request immediate deletion, open an issue on this repository with your Minecraft UUID.

The sync server runs on an OVH VPS located in France (EU). All data is subject to EU/GDPR regulations.

• Essential 1.3.10.8 or 1.3.10.9
• YACL (Yet Another Config Lib)

./gradlew build

Build outputs are generated under the Gradle build directories for the supported loaders.

This project is experimental and depends on Essential internals. Essential updates can break Mixins, cosmetic sync, telemetry blocking, or UI patches.

Essential Patcher is not affiliated with, endorsed by, approved by, or associated with Essential, ModCore Inc., Spark Universe, Mojang, Microsoft, or Minecraft.

See LEGALITY.md for the full legal and technical position.