Iustitia / Docs / Movement / Fly

Fly

[X] Definitive
Flight envelope — three airborne signals while groundedProxy is false: physics breach, hover/AirWalk, and ascend-without-jump. Ported from AvA checkFlight + Nemesis FlyB.
id: flyEnvelope  ·  class: FlyEnvelopeCheck  ·  group: Movement

What it detects

Flight envelope — three airborne signals while groundedProxy is false: physics breach, hover/AirWalk, and ascend-without-jump. Ported from AvA checkFlight + Nemesis FlyB.

Observer signature

Physics breach: dy exceeds gravity-predicted (prevDeltaY-0.08)*0.98 by > threshold (0.1) with recentDescend < 0.5, sustained >=2 ticks. Hover: |dy| < 0.01 with horizontal > 0.1 for >=3 ticks. Ascend: dy > 0.2 with no observed jump impulse within 2 ticks (jump impulse = prevDeltaY < 0.15 && dy > 0.3 && dy < 1.0, debounced >6 ticks).

False-positive guards

  • Vehicle/gliding/riptide/swimming exempt
  • Velocity window (tick - velocityTick < 30)
  • Teleport exempt (clears descend window + hoverTicks)
  • Hurt exempt (tick - hurtTick < 3)
  • Solid block within 2 above head suppresses ascend (chunk unloaded -> treated as blocked)
  • Sustained-levitation guard infers Levitation (LEV_GUARD_TICKS=20) and stops accumulating

Configuration

Defaults (editable in-game via the YACL config screen or /ius config):

FieldDefault
enabledtrue
setbackVL5.0
decay1.0
threshold0.1
breach sustain>=2 ticks
hover|dy|<0.01, horiz>0.1, 3 ticks
LEV_RISE0.2
LEV_GUARD_TICKS20

Source

src/main/kotlin/dev/iustitia/checks/movement/FlyEnvelopeCheck.kt  ↗