Arma 3 Scripting

Command in Object Detection

vehicles

Also available as Markdown and JSON, or read the original wiki page.

Description

Returns an array of all vehicles available to current client. This command returns both empty and crewed vehicles but not soldiers. It will also return "WeaponHolderSimulated" of dead bodies (weapon on the ground). Vehicles created with createVehicleLocal will only be returned on the client that created them.

Syntax

vehicles

Returns: Array of Objects

Examples

Example 1

_vehicles = vehicles;

See also

allGroups · allUnits · units · entities · agents · playableUnits · switchableUnits · allPlayers · allDead · allDeadMen · allUnitsUAV · allCurators · allObjects · allMissionObjects · allSimpleObjects · allMines

Community notes

Sa-Matra

This command returns a lot of crap that is not really a vehicle in a common sense - simulated weapon holders, clutter cutters, etc. It also skips "out" vehicles (disassembled drones and statics). Be careful iterating through it as it may be expensive.

Here is a list of most vehicle simulations that are returned by this command:

airplanex
artillerymarker
car
carx
fire
helicopterrtd
lasertarget
motorcycle
nvmarker
parachute
paraglide
rope
shipx
submarinex
suppresstarget
tankx
thing
thingx

Generated using this code bit:

private _sims = createHashMap;
{
    private _sim = toLowerANSI getText(_x >> "simulation");
    if!(_sim in _sims) then {
        _sims set [_sim, configName _x];
    };
} forEachReversed ("getNumber(_x >> 'scope') > 0" configClasses (configFile >> "CfgVehicles"));

private _used_sims = [];
{
    if(createVehicle [_y, [random 1e5,random 1e5,random 1e5], [], 0, "CAN_COLLIDE"] in vehicles) then {
        _used_sims pushBack _x;
    };
} forEach _sims;

_used_sims sort true;
copyToClipboard (_used_sims joinString toString [10]);

There is probably more simulations not listed like non-x versions of vehicle simulations but these are ones actually used in A3.