Skip to content

shardmods/ProjectileGhostFix

Repository files navigation

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 <projectile>.vs.<target>. 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

About

Fabric server-side mod that reduces projectile ghosting against fast-moving targets

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages