Skip to content

UnitsAttackGround

UnitsAttackGround(units, position) · UnitsAttackGroundTracked(units, position)

Inputs: units contains 1–255 owned, live actors; position is a finite {x=..., y=...} ground point. An invalid actor rejects the whole group.

Description: Sends an immediate native attack-ground order. The tracked form can report invalid-position, invalid-actors, actor-group-too-large, or packet-layout-unavailable. A submitted receipt does not establish firing or impact. GetApiCapability(UnitsAttackGround) checks native readiness, not actor eligibility.

Output: UnitsAttackGround returns true for queue admission, otherwise false. UnitsAttackGroundTracked returns accepted, receipt.

Errors: Wrong Lua argument types raise an argument error. The tracked form can report invalid-position, invalid-actors, actor-group-too-large, or packet-layout-unavailable. A tracked receipt gives the rejection reason when available.