AntiFlight

Minecraft 版本： 1.21.11

平台： fabric

AntiFly

Lightweight Paper + Fabric flight-control plugin by CevAPI.

Current release: 1.1.2

AntiFly is not a full anti-cheat. It focuses on flight and movement abuse with layered checks:

• server-authorized flight state
• server-side ground/support truth
• buffered air/hover/anti-kick suspicion
• ground-flag spoof and sustained flat-air cruise detection
• disciplined setbacks to last known valid support
• Elytra-specific movement and boost sanity checks
• teleport-aware state rebasing - commands, plugin warps, ender pearls, chorus fruit and portals never trigger setbacks

Platforms

• Paper: 1.21.1-26.2 (Folia-supported)
• Fabric: 1.21.11 (Fabric API 0.139.4)
• Fabric: 26.1.2 (Fabric API 0.146.1)
• Fabric: 26.2 (Fabric API 0.154.2)

Install

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

Commands

Paper

Requires op or antifly.admin.

Core:

• /antifly enable
• /antifly disable
• /antifly hungermode <on|off>
• /antifly status
• /antifly help
• /antifly exempt <player>
• /antifly unexempt <player>
• /antifly disabledworlds <worldName> <true|false>
• /antifly set
• /antifly set <key>
• /antifly set <key> <value>
• /antifly reset <player>

Hunger Mode:

• hungerModeMaxBlocksPerSecond - normalized-speed cap (default 200)
• hungerModeHungerPerSecondAtMaxSpeed - food/sec at max speed (default 10)
• hungerModeRocketGraceTicks - free drain window after a firework (default 80)
• hungerModeAirborneMinimumBlocksPerSecond - hover floor (default 20)
• hungerModeFlightDamageEnabled - real-health damage after sustained flight, on/off (default true)
• hungerModeFlightDamageAfterSeconds - airborne seconds before damage starts (default 20)
• hungerModeFlightDamagePerSecond - health lost per second after the delay (default 1)

Alerts:

• /antifly alerts <off|game|console|both>
• game alerts go to ops and users with antifly.alerts

Debug:

• /antifly debug on
• /antifly debug off
• /antifly debug
• Shows live action-bar telemetry (mode, speed vs limits, key buffers)

Fabric

Requires moderator-level command permission.

• /antifly enable / /antifly disable
• /antifly status
• /antifly help
• /antifly alerts <off|game|console|both>
• /antifly debug on|off
• /antifly exempt <player> / /antifly unexempt <player>
• /antifly reset <player>
• /antifly disabledworlds <worldName> <true|false>
• /antifly set lists supported settings; /antifly set <key> <value> changes one.

Primary settings keys (Paper)

• groundWalkMax
• groundMountedMax
• waterMax
• waterVerticalMax
• boatMaxHorizontal
• maxAirHorizontal
• maxAirVertical
• bufferDecay
• horizontalBufferLimit
• verticalBufferLimit
• hoverBufferLimit
• noFallDetectionEnabled
• airNonFallTicksLimit
• antiKickWindowTicks
• antiKickMinDescent
• vehicleAirGraceTicks
• boatAirGraceTicks
• horseAirGraceTicks
• setbackCooldownMs
• elytraEnabled
• elytraBoostGraceTicks
• elytraStallTicks
• elytraMovementBufferLimit
• elytraDurabilityCheckEnabled
• elytraNoRocketMaxAscent
• elytraRequiredDescentForPullup
• elytraMaxRocketHorizontal
• elytraMaxRocketUp
• elytraNoRocketSustainableHorizontal
• elytraMaxNoRocketUp

Legacy aliases kept for backward compatibility:

• groundSpeed, groundSpeedWalking, groundSpeedMounted
• waterSpeed, waterVertical
• airSpeed, airVertical, airNonFallTicks
• elytraMovementLimit

Hunger Mode

• Enable with /antifly hungermode on. It bypasses every AntiFly enforcement check in enabled worlds.
• Moving consumes food quadratically by horizontal speed, capped at 200 blocks/second. The default 200 BPS rate is 10 food points per second.
• Unsupported players have a server-side minimum penalty equivalent to 20 BPS, including stationary hovering. This does not use the client onGround flag, so AntiHunger packet spoofing cannot bypass it.
• Hovering in a vehicle is only exempt while the vehicle itself is supported (boat on water/ground, mount standing); flying in a boat is penalized like any other unsupported flight.
• Rocket-propelled Elytra movement has no Hunger Mode cost during the configured 80-tick rocket grace window. Unassisted Elytra gliding costs half the normal amount, but only while actually moving - hovering with an Elytra drains at the normal hover rate.
• Sustained unsupported flight deals real health damage: after hungerMode.flightDamageAfterSeconds (default 20) of continuous flight without support, players take hungerMode.flightDamagePerSecond (default 1) damage per second. The counter resets the moment they touch ground/support, so stacking food cannot sustain an endless flight - food restores hunger, not health. Toggle with hungerMode.flightDamageEnabled (default true).
• The server cannot reliably distinguish legitimate unassisted glide energy from Elytra-flight cheats, so all no-rocket Elytra gliding receives the same half-rate treatment.

Notes on Elytra

• Rocket-assisted glide is tracked separately from no-rocket glide.
• No-rocket controlled upward/flat cruise behavior is treated as suspicious and can be blocked.
• Repeated movement ground-flag spoofing cannot continually refresh Elytra landing grace.
• Sustained flat-air movement is blocked after 12 air ticks when horizontal movement reaches 0.45 blocks per tick.
• Sustained unsupported air time is rubber-banded after sustainedAirTicksLimit ticks (default 150 = 7.5s), regardless of speed or bobbing patterns — the counter only resets on landing, fluid or vehicle support.
• Rare fluid-exit and early-glide pull-up transitions are given short grace windows to reduce false positives.

Permissions (Paper)

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

Config locations

• Paper: plugins/AntiFly/config.yml
• Fabric: config/antifly.json

World-specific disable

• Paper config supports disabledWorlds: []
• Fabric config supports "disabledWorlds": []
• Add exact world names to disable AntiFly in those worlds, for example world_nether, world_the_end, or any custom multiverse world name
• /antifly status shows the currently disabled worlds

Modrinth version check

• Project slug: antiflight
• /antifly status performs a live check
• Startup check warns ops/admins if outdated