ProjectileGhostFix

ProjectileGhostFix

ProjectileGhostFix reduces server-side projectile ghosting against fast-moving targets. Without ProjectileGhostFix, vanilla projectile collision can miss cases where a projectile starts inside a target's hitbox or crosses a moving target during the same tick.

Installation

Install on the server. A client-only install on multiplayer servers will not affect server-authoritative projectile collision.

Behavior

• Reduces projectile ghosting against fast-moving targets.
• Catches projectile hits that start inside a target's hitbox.
• Catches projectile hits where the projectile and target cross during the same tick.
• Keeps vanilla projectile hits unchanged when vanilla already detects the collision.

Configuration

ProjectileGhostFix creates config/projectile-ghost-fix/projectile-ghost-fix.properties on first launch. The default config enables the fix globally and leaves wind_charge.vs.player disabled, so wind-charge collisions against players stay vanilla unless a server owner opts in.

Server operators can change the config in-game:

/projectileghostfix status
/projectileghostfix on
/projectileghostfix off
/projectileghostfix mode raystart_inside true
/projectileghostfix mode swept_volume true
/projectileghostfix pair set wind_charge player true
/projectileghostfix pair set wind_charge player false
/projectileghostfix pair clear wind_charge player
/projectileghostfix pair list
/projectileghostfix reload

Per-pair overrides use `.vs.. Projectiles are entity registry paths such as wind_charge, ender_pearl, arrow, or any. Targets are player, projectile, other, or any`.

Versions

• 26.1.x: Minecraft Java 26.1 through 26.1.2

Requirements

• Minecraft Java 26.1.x
• Fabric Loader 0.19.2 or newer
• Fabric API 0.149.1 or newer

License

Unlicense