Public API contractVerified 2026-09-27Not yet executable

Branch contract: explicit flight requires a matching distributed build and live acceptance.

Normal flight

Use locomotion = "flight" to request normal flight when the server permits it:

local result = hexis.await(hexis.navigate.to({
    destination = {x = 12.25, y = 78.5, z = -8.75},
    locomotion = "flight",
    arrive_within = 2,
}), {timeout = 30})

Your bundle needs navigation and pathfinding. Flight preserves the destination's fractional coordinates and requires a loaded route with room for the player. It rejects the walking options allow_drops, allow_parkour, allow_sneak, temporary_support, and allow_ether_transmission when enabled. It does not use Blink.

interact.entity also accepts locomotion = "flight". Use it when an observed entity requires an aerial approach; actual interaction reach and visibility still gate the use input. Walking remains the default for both actions.

Flight permission loss, changed world or lost control stops the attempt. Success confirms local arrival or consumed interaction input. Check the expected server effect separately.