{"name":"emptyPositions","title":"emptyPositions","type":"command","url":"https://community.bistudio.com/wiki/emptyPositions","revid":378582,"updated":"2026-05-11T11:45:50Z","groups":["Object Manipulation","Unit Control"],"status":"ok","games":{"arma1":"1.00","arma2":"1.00","arma2oa":"1.50","tkoh":"1.00","arma3":"0.50"},"since":"arma1 1.00","arma3_since":"0.50","description":"Returns the number of given empty positions in the vehicle.\n\n> [!NOTE]\n> To return the actual units in the vehicle use fullCrew. However if only the number is desired, use emptyPositions because it is faster.","syntaxes":[{"syntax":"vehicle emptyPositions position","params":[{"name":"vehicle","type":"Object","description":"transport","type_expr":"Object"},{"name":"position","type":"String","description":"can be one of:\n\n- `\"Commander\"`\n- `\"Driver\"`\n- `\"Gunner\"`\n- `\"Cargo\"` - all cargo positions, FFV or not\n- Arma 3 v2.10 `\"\"` - all empty positions\n- Arma 3 v2.10 `\"CargoNoFFV\"` - non-FFV cargo\n- Arma 3 v2.10 `\"CargoFFV\"` - FFV cargo\n- Arma 3 v2.14 `\"Turret\"` - empty turrets (no FFV turrets, they are included in \"CargoFFV\")","type_expr":"String"}],"returns":{"type":"Number","type_expr":"Number","description":"the number of available positions ignoring locked positions"},"form":"binary","left":{"text":"vehicle"},"right":{"text":"position"}},{"syntax":"vehicle emptyPositions [position, ignoreLocked]","since":"arma3 2.22","params":[{"name":"vehicle","type":"Object","description":"transport","type_expr":"Object"},{"name":"position","type":"String","description":"see moveInAny. Empty string \"\" returns number of all free positions","type_expr":"String"},{"name":"ignoreLocked","type":"Boolean","optional":true,"default":"false","description":"true to ignore locked positions.","type_expr":"Boolean","text":"ignoreLocked (Optional): Boolean - true to ignore locked positions. Default: false"}],"returns":{"type":"Number","type_expr":"Number","description":"the number of available positions ignoring locked positions"},"form":"binary","left":{"text":"vehicle"},"right":{"text":"[position, ignoreLocked]"}}],"examples":[{"code":["_freeCargoAndFFVPositions = vehicle player emptyPositions \"Cargo\";"]},{"code":["_freeCargoOnlyPositions = vehicle player emptyPositions \"CargoNoFFV\";"]}],"see_also":["moveInDriver","moveInTurret","moveInCommander","moveInGunner","moveInCargo","getCargoIndex","moveInAny"],"notes":[{"user":"DreadedEntity","date":"2022-03-20T00:08:54Z","text":"**emptyPositions** combines both turret and cargo in its output. If you must know the true count of either, you will have to use fullCrew (tested on several vehicles)\n\nI have not found a way to test for copilot in helicopters"}]}