CraftHub
AntiFlight

AntiFlight

Paper Plugin and Fabric mod to exclusively prevent flight and speed based hacks, including Elytra and BoatFly etc. Achieved without simulation and made as simple as possible.

4 576 downloads
9 followers

AntiFly

LOGO

Lightweight Paper + Fabric flight-control plugin by CevAPI.

Current release: 1.1.3

AntiFly is not a full anti-cheat - it focuses on flight/movement abuse with layered checks:

  • server-side ground/support truth (never trusts client onGround)
  • buffered air/hover/anti-kick suspicion + sustained-air detection
  • disciplined setbacks to last known valid support
  • Elytra checks that only flag what vanilla physics can't do (speed, instant vertical, stall)
  • teleport-aware rebasing; /tp, pearls, chorus, portals never trigger setbacks
  • Hunger Mode, a configurable food/health tax instead of hard blocks

Platforms

  • Paper: 1.21.1-26.2 (Folia-supported)
  • Fabric: 1.21.11 / 26.1.2 / 26.2

Install

  • Paper: drop the jar into plugins/
  • Fabric: drop the jar into mods/

Commands

Same set on Paper & Fabric. Requires op / antifly.admin on Paper, moderator-level on Fabric.

  • /antifly enable|disable|status|help
  • /antifly hungermode <on|off>
  • /antifly set - lists every tunable key with its current value
  • /antifly set <key> - read one value (accepts canonical keys, unambiguous section-child names, and dotted YAML paths)
  • /antifly set <key> <value> - set one (applies instantly, auto-saves)
  • /antifly alerts <off|game|console|both>
  • /antifly debug <on|off>
  • /antifly exempt <player> / /antifly unexempt <player>
  • /antifly reset <player>
  • /antifly disabledworlds <worldName> <true|false>

Tuning keys

All adjustable live via /antifly set. Defaults in brackets.

Movement

groundWalkMax (0.67) · groundMountedMax (0.75) · waterMax (0.55) · waterVerticalMax (0.7) · boatMaxHorizontal (0.85) · maxAirHorizontal (1.8) · maxAirVertical (1.0) · sustainedAirTicksLimit (150)

Elytra

Same keys on both platforms. On Fabric the rocket/no-rocket variants map to the single caps elytraMaxHorizontal (6.0) and elytraMaxUp (4.0); on Paper they're independent.

  • elytraMaxHorizontal / elytraNoRocketSustainableHorizontal / elytraMaxRocketHorizontal
  • elytraMaxUp / elytraMaxNoRocketUp / elytraMaxRocketUp
  • elytraEnabled · elytraBoostGraceTicks · elytraStallTicks · elytraMovementBufferLimit

Hunger Mode

  • hungerModeMaxBlocksPerSecond (200) · hungerModeHungerPerSecondAtMaxSpeed (10) · hungerModeRocketGraceTicks (80) · hungerModeAirborneMinimumBlocksPerSecond (20)
  • hungerModeFlightDamageEnabled (true) · hungerModeFlightDamageAfterSeconds (20) · hungerModeFlightDamageAfterHungerSeconds (30) · hungerModeFlightDamagePerSecond (1)
  • hungerModeElytraFoodEnabled (true) · hungerModeElytraFoodMultiplier (0.5) · hungerModeElytraSpeedThresholdBps (50) · hungerModeElytraNoRocketAfterSeconds (45) · hungerModeElytraDamageEnabled (true) · hungerModeRocketResetsDamage (true)

Hunger Mode

  • /antifly hungermode on replaces hard movement blocks with a food-and-health penalty. It uses server-accepted movement and does not trust client onGround.
  • Above the airborne floor, drain scales quadratically with horizontal speed. The airborne minimum is a linear hover baseline: with maxBlocksPerSecond: 200, airborneMinimumBlocksPerSecond: 20, and hungerPerSecondAtMaxSpeed: 5, idle hovering costs 0.5 food points/sec.
  • Food loss is applied continuously (at most one food point per tick); landing or regaining support immediately clears any pending flight debt.
  • Unsupported non-Elytra flight normally starts health damage after 20 seconds. Reaching food level 0 escalates immediately to flight damage; flightDamagePerSecond is measured in health points (1.0 = half a heart), and is doubled at zero food (so 1.0 = one full heart). Flight damage is generic, so it stacks with vanilla starvation.
  • Elytra is only punished when exploiting: above the speed threshold, hover-hacking, or gliding too long without a rocket. Rocket-assisted vanilla gliding is free; Elytra health damage otherwise starts after its configured active-drain period.

Notes on Elytra

  • Checks only block what vanilla can't do: sustained speed beyond ~6 b/t, instant climbs beyond ~4 b/t, and stall-hovering. Steep dives, pull-ups, rocket boosts and crashing into obstacles are all allowed.
  • Repeated ground-flag spoofing can't refresh landing grace; sustained flat-air movement is blocked after 20 air ticks at 0.45 b/t.

Permissions (Paper)

  • antifly.admin (default: op) · antifly.alerts (default: op)

Config

  • Paper: plugins/AntiFly/config.yml · Fabric: config/antifly.json
  • Disable AntiFly per world with disabledWorlds: [] on either platform
  • Modrinth check (slug antiflight): /antifly status + startup warning when outdated

No gallery available for this project.