{"name":"BIS_fnc_objectSide","title":"BIS fnc objectSide","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_objectSide","revid":379506,"updated":"2026-10-31T00:27:50Z","groups":["Sides"],"status":"ok","games":{"arma3":"1.00"},"since":"arma3 1.00","arma3_since":"1.00","description":"Returns object side as defined in config (i.e. not affected by dynamic changing like rating)","syntaxes":[{"syntax":"[target, boolean] call BIS_fnc_objectSide","params":[{"name":"target","type":"Object","description":"the object to be tested","type_expr":"Object"},{"name":"boolean","type":"Boolean","optional":true,"default":"false","description":"false to return actual object side, true to return the default config value","type_expr":"Boolean","text":"boolean: Boolean - (Optional, default false) false to return actual object side, true to return the default config value"}],"returns":{"type":"Side","type_expr":"Side"}},{"syntax":"target call BIS_fnc_objectSide","params":[{"name":"target","type":"Object","description":"the object to be tested. This syntax is equal to calling the method with false as a second parameter.","type_expr":"Object"}],"returns":{"type":"Side","type_expr":"Side"}}],"examples":[{"code":["private _realVehicleSide = [vehicle player, true] call BIS_fnc_objectSide;"]},{"code":["private _unknownSide = [objNull, false] call BIS_fnc_objectSide; // will return sideUnknown\nprivate _eastSide    = [objNull, true]  call BIS_fnc_objectSide; // will return east"]},{"code":["// same results\n_result1 = myVehicle call BIS_fnc_objectSide;\n_result2 = [myVehicle] call BIS_fnc_objectSide;\n_result3 = [myVehicle, false] call BIS_fnc_objectSide;"]}],"see_also":["side","CfgVehicles Config Reference","Side","playerSide","west","east","resistance","civilian","sideLogic","sideFriendly","sideEnemy","sideUnknown","sideEmpty","sideAmbientLife","Side Relations","BIS_fnc_sideID"],"notes":[{"user":"Tankbuster","date":"2020-04-01T17:25:00Z","text":"When using this to get the side of vehicle drivers, be aware that when the boolean parameter is true, empty vehicles will return their driver as east.\nThe same vehicle, when the boolean parameter is false, will return \"UNKNOWN\""}]}