# \ud83c\udfaf DiolezHitregistry \u2014 Ghost Hit Elimination & PvP Desync Fix<\/p>\n
> **Feel every swing land. No more ghost hits. No more rubber-band deaths.**
\n> Client-side combat prediction for Minecraft 1.21 (Fabric) \u2014 zero server-side dependencies.<\/p>\n
—<\/p>\n
## \u2753 What Problem Does This Solve?<\/p>\n
You’ve felt it before. You swing on a player, the hit animation plays, particles fly \u2014 and nothing happens. Their health doesn’t move. You didn’t deal damage. The server didn’t agree.<\/p>\n
That’s a **ghost hit** \u2014 caused by the gap between what your client sees and what the server processes. It gets worse the higher your ping is.<\/p>\n
**DiolezHitregistry eliminates this feeling entirely.**<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
### \u2694\ufe0f Ghost Hit Elimination
\nEvery swing instantly applies a **visual health reduction** to your target. If the server confirms the hit \u2014 perfect, it already looks right. If the server rejects it due to lag or tick desync \u2014 the health bar smoothly fades back to the real value. No jarring snap. No confusion.<\/p>\n
### \ud83e\udde0 Combat Prediction & Reconciliation
\nThe mod timestamps every attack the moment you swing and tracks a **live round-trip time estimate** from your current ping. It uses this to calibrate a tolerance window \u2014 giving the server enough time to respond before deciding a hit was a ghost. On 150ms+ connections, this window automatically widens to absorb lag spikes.<\/p>\n
### \ud83d\udd27 Utility Desync Fixes
\nAll of these actions are predicted immediately and rolled back gracefully if the server disagrees:<\/p>\n
– \ud83d\udfe3 **Ender pearls** \u2014 arc and trajectory appear instantly on throw
\n– \ud83c\udff9 **Bow & crossbow** \u2014 projectile predicted on release
\n– \ud83c\udf57 **Food & potions** \u2014 consume animation plays without waiting for server
\n– \ud83e\uddf1 **Block placement** \u2014 block appears in world before server acknowledgement
\n– \ud83c\udf92 **Hotbar switching** \u2014 slot change is instant, rolled back if server denies<\/p>\n
### \ud83d\udcca Live RTT Calibration
\nThe mod continuously measures your actual ping and uses it to dynamically tune prediction windows \u2014 no manual configuration needed. It works well at 20ms and still feels great at 300ms+.<\/p>\n
### \ud83d\udc1b Debug Overlay (Optional)
\nEnable a developer HUD that shows in real-time:
\n– Estimated RTT and tick-boundary crossing risk
\n– Visual HP vs real HP on your current target
\n– Prediction status (pending \/ confirmed \/ rolled back)
\n– Entity position error (how far the server-side target is from what you see)<\/p>\n
—<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
Config file is auto-created at: `.minecraft\/config\/hitregistry.json`<\/p>\n
| Option | Default | Description |
\n|—|—|—|
\n| `enabled` | `true` | Master on\/off toggle |
\n| `combatPredictionEnabled` | `true` | Toggle hit prediction |
\n| `utilityPredictionEnabled` | `true` | Toggle utility desync fixes |
\n| `hitExpiryTicks` | `20` | How long to wait for server confirmation before treating as ghost hit |
\n| `latencyCompensationTicks` | `2` | Extra ticks added to the window for high-ping servers |
\n| `predictionStrength` | `0.85` | How aggressively visual damage is predicted (0.0\u20131.0) |
\n| `rollbackLerpSpeed` | `0.3` | How fast visual HP snaps back on rollback |
\n| `pearlPredictionEnabled` | `true` | Ender pearl desync fix |
\n| `projectilePredictionEnabled` | `true` | Bow\/crossbow desync fix |
\n| `itemUsePredictionEnabled` | `true` | Food\/potion desync fix |
\n| `blockPlacementPredictionEnabled` | `true` | Block placement desync fix |
\n| `utilityRollbackDelayMs` | `400` | ms to wait before rolling back an unconfirmed utility action |
\n| `debugLogging` | `false` | Verbose console logging |
\n| `debugOverlay` | `false` | Enable HUD debug panel |<\/p>\n
### \ud83d\udd34 High Ping (150ms+) Recommended Settings
\n“`json
\n{
\n “hitExpiryTicks”: 30,
\n “latencyCompensationTicks”: 5,
\n “predictionStrength”: 0.90,
\n “utilityRollbackDelayMs”: 600
\n}
\n“`<\/p>\n
### \ud83d\udfe2 Strict Server \/ Anti-Cheat Sensitive Settings
\n“`json
\n{
\n “hitExpiryTicks”: 12,
\n “latencyCompensationTicks”: 1,
\n “predictionStrength”: 0.70,
\n “utilityRollbackDelayMs”: 300
\n}
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udee1\ufe0f Anti-Cheat Compatibility<\/p>\n
This mod is designed from the ground up to be **invisible to anti-cheat systems**.<\/p>\n
| What this mod does | Safe? |
\n|—|—|
\n| Apply visual health reduction before server confirms | \u2705 Purely cosmetic \u2014 never touches the entity’s real health value |
\n| Lerp visual health back on rollback | \u2705 Client-side rendering only |
\n| Timestamp and track pending actions | \u2705 No network interaction |
\n| Inject into vanilla methods | \u2705 Read-only, post-execution \u2014 never cancels anything |
\n| Send extra attack packets | \u274c Never \u2014 would trigger hit-rate limiters |
\n| Modify outgoing packet timing | \u274c Never \u2014 server-side manipulation = ban |
\n| Alter entity positions | \u274c Never \u2014 position spoofing = instant Grim ban |
\n| Cancel incoming server packets | \u274c Never \u2014 would desync the client |<\/p>\n
**Compatible with: Grim Anticheat, Vulcan, NoCheatPlus, Matrix, and all standard server anti-cheats.**
\nAll prediction logic is **purely visual**. The server always remains authoritative.<\/p>\n
—<\/p>\n
## \u2753 FAQ<\/p>\n
**Q: Does this work on servers I don’t own?**
\nA: Yes. It’s 100% client-side. No server mod or plugin required.<\/p>\n
**Q: Will this get me banned?**
\nA: No. The mod never sends extra packets, never modifies outgoing attack packets, and never alters any authoritative server state. All changes are visual-only on your own client.<\/p>\n
**Q: Does it work in singleplayer?**
\nA: Yes, though at 0ms local latency, ghost hits don’t occur naturally \u2014 so you won’t see much difference there.<\/p>\n
**Q: Why does the health bar sometimes snap a little before correcting?**
\nA: That’s the rollback lerp. When the server contradicts a prediction, the visual HP smoothly returns to the real value. You can adjust `rollbackLerpSpeed` in the config to make it faster or slower.<\/p>\n
**Q: Can I disable specific features?**
\nA: Yes. Every feature has its own toggle in `hitregistry.json`. You can run combat prediction only, utility prediction only, or mix and match.<\/p>\n
**Q: Is this the same as reach or kill-aura mods?**
\nA: Absolutely not. This mod does not extend your reach, automate attacks, or alter hitboxes. It only improves visual feedback and desync recovery for actions you take yourself.<\/p>\n
—<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Install **Fabric Loader** for Minecraft 1.21
\n2. Install **Fabric API**
\n3. Drop `DiolezHitregistry-1.0.0.jar` into your `.minecraft\/mods\/` folder
\n4. Launch \u2014 config is created automatically on first run<\/p>\n
—<\/p>\n
## \u26a0\ufe0f Known Limitations<\/p>\n
True zero-latency PvP is physically impossible over a network. Here’s what we simulate and why each limit exists:<\/p>\n
– **Invincibility frames (iFrames):** After being hit, entities have a server-side 10-tick invincibility window. The client can’t know exact iFrame state for other players, so some hits during this window may appear as ghost hits locally even when they’re valid server-side.<\/p>\n
– **Bow draw power:** Draw state is tracked server-side. Projectile velocity prediction may be slightly off if the bow wasn’t fully drawn.<\/p>\n
– **Armour & enchantment precision:** The damage estimator uses visible attributes only and applies a 10% conservative reduction. Actual server damage (post-armour toughness, Protection enchants) will differ slightly, causing a small visual correction when the server responds.<\/p>\n
– **Packet batching:** Some server configs batch health sync packets, delaying rollback triggers by an extra tick or two.<\/p>\n
—<\/p>\n
## \ud83d\udd17 Source Code<\/p>\n
Full source code with architecture documentation and inline comments explaining every design decision is included in the project.<\/p>\n
**Built with:** Fabric API \u00b7 Fabric Mixins \u00b7 Java 21 \u00b7 Minecraft 1.21 Yarn Mappings<\/p>\n
—<\/p>\n
*Made by Diolez*<\/p>\n","protected":false},"excerpt":{"rendered":"
A solution for ghost hit elimination and pvp desync fix.<\/p>\n","protected":false},"featured_media":57014,"template":"","meta":{"_minecraft_slug":"diolezhitregistry","_minecraft_project_id":"DsL0pTWX","_minecraft_author":"Diolezz","_minecraft_license":"MIT","_minecraft_downloads":192,"_minecraft_follows":1,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"diolezhitregistry.zip","_minecraft_size_bytes":47035,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T14:52:46.888316Z","_minecraft_date_created":"2026-04-29T05:26:30.684777Z","_minecraft_date_modified":"2026-04-11T08:12:57.567616Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/diolezhitregistry","_minecraft_icon_attachment_id":57014,"_minecraft_imported_at":"2026-06-03T03:27:53+00:00","_minecraft_import_hash":"56ea90f802ef5533b92b71e6c57afbfc","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[88,97,89,92],"mod_loader":[99],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-57013","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-equipment","mod_category-fabric","mod_category-game-mechanics","mod_category-utility","mod_loader-fabric","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n