Anti Golden Apple Ghost v1.2
Eliminates Ghost Golden Apples And Absorption Hearts Desync Fix
AntiGapGhost
Eliminates Ghost Golden Apples. Absorption Hearts Desync Fix.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Golden Apple Desync Fix ◆ Absorption-consume Fix ◆ Folia Support ◆ Paper 1.21.x - 26.2 ◆ API + Events
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
What AntiGapGhost Solves
Minecraft's client-server model has a known weakness: absorption hearts are part of the entity metadata, and after a golden apple is eaten the server and clients can disagree on that metadata. Other clients see a ghost - hearts that never appear, appear late, or stay after the damage already consumed them. The player looks wrong to every observer until something forces a full re-sync.
AntiGapGhost fixes this. It re-renders the player entity to every viewer the moment a golden or enchanted golden apple is eaten, and again when the absorption is fully consumed by damage (Mojira MC-202432, MC-205043). The result is correct golden hearts for every observer.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Two Fix Triggers. Independently Configurable.
Each trigger has its own toggle, delay-ticks, and optional sub-settings.
Each trigger can be disabled independently without touching the others.
◆ On Consume
◆ On Absorption Consumed
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Core Systems
◆ Reliable Re-render
◆ Desync Scan
◆ Throttle System
◆ Exemption System
◆ World Scoping
◆ Statistics
◆ Developer API
◆ Multi-Language Support
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
How AntiGapGhost Compares
Two Fix Triggers. Independently Configurable.
Each trigger has its own toggle, delay-ticks, and optional sub-settings.
Each trigger can be disabled independently without touching the others.
◆ On Consume
- Golden Apple Fires after PlayerItemConsumeEvent. Configurable delay lets absorption apply server-side first.
- Enchanted Golden Apple Same fix for the enchanted variant. Optional enchanted-only mode.
◆ On Absorption Consumed
- Re-renders when the golden hearts are fully used up by damage, clearing the "effect stays after hearts are gone" desync (Mojira MC-202432, MC-205043).
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Core Systems
◆ Reliable Re-render
- Uses Paper's getTrackedBy() API to hide and re-show the player to every viewer
- Scheduled on the viewer's own region thread - cross-region and Folia safe
- Also refreshes the surrounding chunks and the player's inventory
◆ Desync Scan
- Periodic background scan that computes desynced viewers and exposes them via %antigapghost_desync%
- Configurable interval and view distance
◆ Throttle System
- Per-reason minimum ticks between fixes for the same player+reason pair
- Prevents spam from rapid eating or damage
◆ Exemption System
- Permission-based: grant antigapghost.exempt to skip specific players
- UUID whitelist for hard-coded exemptions
- NPC auto-detection via Citizens and ModelEngine hooks - NPCs are never processed
◆ World Scoping
- Blacklist or whitelist mode for worlds
- Disable the plugin in specific worlds (e.g., event worlds, lobbies)
◆ Statistics
- Per-player fix counters for every reason, visible via /antigapghost stats
- Optional persistence to file on a configurable interval
- PlaceholderAPI expansion for scoreboards and holograms
◆ Developer API
- AntiGapGhostAPI registered via Bukkit ServicesManager for easy access
- GhostFixEvent - cancellable, fired before a fix. Let other plugins veto fixes
- GhostFixedEvent - fired after a fix completes
- refreshPlayer(), refreshSurroundings(), getStats(), isExempt() - full API surface
◆ Multi-Language Support
- Built-in: English and Polish. Add custom languages by dropping a file in /lang/
- All messages use MiniMessage with full hex color and gradient support
- Language switch is a single line in config.yml
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
How AntiGapGhost Compares
| Feature | AntiGapGhost | Manual / Simple Plugins |
| Trigger coverage | Consume + absorption-consumed with per-trigger config | Golden apple only or nothing |
| Fix method | getTrackedBy() hide/show re-render + chunk refresh | Blind chunk resend or none |
| Spam protection | Per-reason throttle, exemption, world scope | None or a basic global cooldown |
| Folia support | Fully supported via entity scheduler | Most break on Folia |
| API & events | Bukkit ServicesManager API + 2 events | No API surface |
| NPC handling | Citizens and ModelEngine auto-skip | Not handled |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Who This Is For
- PvP servers Golden apples are the core of PvP. Ghost hearts ruin every fight. AntiGapGhost keeps absorption correct for every observer.
- Survival and SMP Players using gapples against bosses or in raids will never show stale health to their friends again.
- Network owners Works on any server running Paper 1.21.x through 26.2. Full /antigapghost reload support, Folia-compatible out of the box. Works alongside any other plugin.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Technical Specs
| Server | Paper 1.21.x - 26.2, Java 25 |
| Dependencies | None. All features work standalone. |
| Soft dependencies | PlaceholderAPI, Citizens, ModelEngine |
| Languages | en_US, pl_PL (extensible) |
| Analytics | bStats, optional, toggle in config |
| Threading | Folia-safe entity scheduler. Async detection, sync execution |
◆ Commands
| Command | Description | Permission |
| /antigapghost info | Shows plugin version, module status, and hook availability | none |
| /antigapghost reload | Reloads config and language files without server restart | antigapghost.admin |
| /antigapghost refresh [player] | Manually refreshes a player's tracker state | antigapghost.refresh |
| /antigapghost fixall | Refreshes all online players at once | antigapghost.admin |
| /antigapghost stats [player] | Displays per-reason fix statistics for a player | antigapghost.stats |
| /antigapghost debug | Shows live tracker state for debugging desync issues | antigapghost.admin |
◆ Permissions
| Permission | Description | Default |
| antigapghost.admin | Access to admin commands (reload, fixall, debug) | op |
| antigapghost.refresh | Manually refresh players | op |
| antigapghost.stats | View fix statistics | true |
| antigapghost.exempt | Player is skipped by all AntiGapGhost actions | false |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Get AntiGapGhost
Ghost golden hearts are not a client-side issue. They are a server-side desync with a server-side fix.
Two triggers. Reliable re-render. Zero ghost hearts. One plugin.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Related Products (1)
Anti Totem Ghost
Creator Premium
The definitive ghost-player fix for Your server
(0)
0 Sales
€4.99
Product Info
Statistics
5
Views
0
Purchases
0
Downloads
76.50 KB
File size
31.08.2026
Published
31.08.2026
Updated
Info
Supported Versions
1.21 - 26.2
Share & Earn
Share and earn part of the profits, an estimated €0.4 per product sale.
Product Image
Links
