{"name":"BIS_fnc_locations","title":"BIS fnc locations","type":"function","url":"https://community.bistudio.com/wiki/BIS_fnc_locations","revid":379501,"updated":"2026-10-31T00:27:10Z","groups":["Systems"],"status":"ok","games":{"arma2":"1.00","arma2oa":"1.50","tkoh":"1.00","arma3":"0.50"},"since":"arma2 1.00","arma3_since":"0.50","description":"Creates or registers location logics (used in various modules, like Ambient Civilians, Ambient Civilian Vehicles or Warfare 2).\n\nUpon registering, function will set following variables into location logic's variable space:\n\n- \"class\" - unique class of location (either `BIS_loc_<configname>` or `BIS_loc_custom_<ID>`)\n- \"name\" - name of location from config or setName command. If none is defined, class is used\n- \"type\" - config type\n- \"neighbors\" - config defined neighbor locations\n\nIf you are registering currently existing object and some of variables above is already stored in it, it will **not** be replaced.","syntaxes":[{"syntax":"[types, area, debug] call BIS_fnc_locations","params":[{"name":"types","type":"String or Array of Strings","type_expr":"String | Array<String>"},{"name":"area","type":"Array in format [center, distance]","type_expr":"Array"},{"name":"debug","type":"Boolean","optional":true,"type_expr":"Boolean","text":"debug: Boolean (Optional)"}],"returns":{"type":"Array","type_expr":"Array","description":"list of registered locations"}},{"syntax":"[objects] call BIS_fnc_locations","params":[{"name":"objects","type":"Array of Objects or Locations","description":"list of specific locations to be registered","type_expr":"Array<Object | Location>"}],"returns":{"type":"Array","type_expr":"Array","description":"list of registered locations"}}],"examples":[{"code":["[\"CityCenter\", [getPosATL player, 1000]] call BIS_fnc_locations;"]},{"code":["[[\"acityc_dolina\"]] call BIS_fnc_locations;"]},{"code":["[[myLocation1, myLocation2], [], true] call BIS_fnc_locations;"]}],"see_also":["Functions Library"],"notes":[{"user":"Str","date":"2009-05-31T15:15:00Z","text":"You can also use `\"\" call BIS_fnc_locations` for quick debug of all locations on landscape"}]}