UnitsBuildStructure

UnitsBuildStructure(builders, buildingType, position, options?) · UnitsBuildStructureTracked(builders, buildingType, position, options?)

Inputs: builders is one owned builder or a dense array; buildingType is an integer ID in 0..32767; position is a map point. Most scripts should omit options: its native fields depend on the game release.

Description: Requests a building placement. The tracked form rejects invalid group members. Neither admission nor submission proves legal placement or a new foundation; look for it in later game state.

Output: UnitsBuildStructure returns true for queue admission, otherwise false. UnitsBuildStructureTracked returns accepted, receipt.

Errors: Wrong Lua argument types raise an argument error. Invalid building IDs, builders, positions, options, missing layout, or a changed session reject. Game placement rules can still prevent a foundation after submission. A tracked receipt gives the rejection reason when available.