btech.autopilot package

btech.autopilot provides typed, notification-free administration of an autopilot’s association, engagement, order queue, runtime modes, and events.

Orders are strict tables discriminated by a typed name constant; unknown fields and raw-string discriminators are rejected. Coordinates must be integers from 0 through 2147483647. Unit targets must currently be registered BattleTech units, although mutable execution conditions such as map bounds, terrain, damage, startup state, and carrier relationships are checked only when the order executes.

FunctionDescription
statusReturn association, queue, and runtime modes.
add_orderAppend a validated typed order.
remove_orderRemove an order by one-based position.
clear_ordersClear a safely inactive queue.
engageAssociate and start an installed autopilot.
disengageStop activity while preserving association and orders.
event_statsCount pending autopilot events.

Constants

NamespaceDescription
ordersOrder-name discriminators.
directionsBase-entry directions.
roam_modesRoaming behaviors.
autogun_modesAutomatic-gunnery behaviors.

Mutators return no values. Failures raise structured errors; operation failures use btech.operation.failed with a stable error.detail.reason. Every function requires the documented arguments and ignores surplus positional arguments, consistently with the rest of the native BTech API.