Arma 3 Scripting

Command in Sides

side

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

Description

Returns the side of a unit, vehicle, object or location.

Note

Converting a side to string will not always return the side command text: e.g str resistance; // returns "GUER".

See Side page to see the return value of all side commands.

Syntax

side target

Parameters:

Returns: Side

Examples

Example 1

if (side player == west) then { hint "Player is on the West side" };

Example 2

_sideAlsoWorkingForDead = side group _deadUnit;

Example 3

_sideLocation = side myLocation;

Example 4

if (side player != playerSide) then { hint "player is renegade or dead"; };

Example 5

Check the side of the vehicle:

_vehicleSide = side group _vehicle; // sideUnknown (CIV for Arma 3) if empty or dead crew, otherwise the appropriate side

See also

CfgVehicles Config Reference · Side · playerSide · west · east · resistance · civilian · sideLogic · sideFriendly · sideEnemy · sideUnknown · sideEmpty · sideAmbientLife · Side Relations · BIS_fnc_sideID · BIS_fnc_objectSide

Community notes

Ceeeb

In Arma, the following objects are on side civilian: dead bodies and vehicles, empty vehicles, all mission editor placed objects (that do not have an inherit side), all objects with interactive components such as ladders and doors, man made structures such as buildings (including classless wrp placed objects), docks, high tension powerlines, see-saws, large rubbish bins, fountains. Basically if an object uses a non-simple damage or physics simulation it is likely to be on the civilian side.

NOTE: If you need to know the side of a dead body, you can use faction command as a workaround -- Killzone_Kid

Ceeeb

In Operation Flashpoint v1.96, the side return value for a vehicle is based on the side of its commander, then gunner, then driver, then cargo. It will retain its side value until it is either empty, or a unit of another side takes over in a equal or higher role, irrespective of the side of other units still on board. This can be used to simulate friendly fire, as a vehicle can be made to appear to be an enemy even though all units on board are actually friendly.

Tankbuster

As Ceeeb says above, in Arma 2, side for a vehicle often depends on who the command or driver is, for example, A KA52, piloted by a USMC guy will have side WEST. For an accurate result of what 'where the vehicle was made', use faction. This ignores the pilot/commander, so in my example here, this KA52 will always return faction "RU". Note that faction returns different values to side though.

RKurtzDmitriyev

Side values for ambient life (animals) are bizarre. side _unit returns "CIV", but playerSide returns "AMBIENT LIFE" when the player is an animal. In that case, playerSide == side player; returns false!

Fortunately, you can easily check if a unit is an animal with _unit isKindOf "ANIMAL";