nearestTerrainObjects

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

1.54

Hover & click on the images for description

Description

Description:

Returns a list of nearest terrain objects of the given types to the given position or object, within the specified distance. If more than one object is found they will be ordered according to 3D distance to the object (i.e. the closest one will be first in the array). In contrast to nearestObjects this command returns terrain placed objects like trees, rocks and buildings which don't necessarily need an associated config class.

Possible type names:

"BUILDING"
"BUNKER"
"BUSH"
"BUSSTOP"
"CHAPEL"
"CHURCH"
"CROSS"
"FENCE"
"FOREST BORDER"
"FOREST SQUARE"
"FOREST TRIANGLE"
"FOREST"
"FORTRESS"
"FOUNTAIN"
"FUELSTATION"
"HIDE"
"HOSPITAL"
"HOUSE"
"LIGHTHOUSE"
"MAIN ROAD"
"POWER LINES"
"POWERSOLAR"
"POWERWAVE"
"POWERWIND"
"QUAY"
"RAILWAY"
"ROAD"
"ROCK"
"ROCKS"
"RUIN"
"SHIPWRECK"
"SMALL TREE"
"STACK"
"TOURISM"
"TRACK"
"TRAIL"
"TRANSMITTER"
"TREE"
"VIEW-TOWER"
"WALL"
"WATERTOWER"

⚠

The names are / The filter is based on the named property map - not on the named property class or any config definition!

ⓘ

Types which are missing are not present in the given world. Virtual Reality has no terrain objects. Last updated

2.12

Stratis

BUSH: 47974
CHAPEL: 2
CROSS: 1
FENCE: 1728
FUELSTATION: 3
HIDE: 70975
HOUSE: 684
LIGHTHOUSE: 3
ROAD: 143
ROCK: 820
SHIPWRECK: 11
TRACK: 2063
TRANSMITTER: 11
TREE: 40110
WALL: 1355
WATERTOWER: 1

Altis

BUSH: 747193
CHAPEL: 165
CHURCH: 54
CROSS: 48
FENCE: 47940
FUELSTATION: 32
HIDE: 655958
HOSPITAL: 1
HOUSE: 17472
LIGHTHOUSE: 7
MAIN ROAD: 2061
POWER LINES: 2224
POWERSOLAR: 10
POWERWAVE: 51
POWERWIND: 128
ROAD: 4849
ROCK: 5483
RUIN: 3
SHIPWRECK: 43
TOURISM: 1
TRACK: 26823
TRANSMITTER: 23
TREE: 263630
WALL: 38943
WATERTOWER: 10

Malden 2035

BUSH: 288461
BUSSTOP: 45
CHAPEL: 14
CHURCH: 14
CROSS: 16
FENCE: 11189
FUELSTATION: 24
HIDE: 192553
HOUSE: 4062
LIGHTHOUSE: 15
MAIN ROAD: 1050
POWER LINES: 3427
POWERSOLAR: 1
ROAD: 1442
ROCK: 3513
SHIPWRECK: 23
TRACK: 3489
TRANSMITTER: 7
TREE: 101960
WALL: 14189
WATERTOWER: 63

Tanoa

BUSH: 754347
CHURCH: 21
FENCE: 2912
FUELSTATION: 85
HIDE: 356904
HOUSE: 13389
MAIN ROAD: 2921
POWER LINES: 3985
POWERSOLAR: 2
POWERWIND: 19
RAILWAY: 2138
ROAD: 1485
ROCK: 8909
SHIPWRECK: 58
TOURISM: 35
TRACK: 9419
TRAIL: 6936
TRANSMITTER: 16
TREE: 506993
WALL: 20526
WATERTOWER: 73

Livonia

BUILDING: 1262
BUNKER: 40
BUSH: 473543
BUSSTOP: 73
CHAPEL: 8
CHURCH: 17
FENCE: 48426
FOUNTAIN: 36
FUELSTATION: 7
HIDE: 474123
HOUSE: 6762
MAIN ROAD: 2118
POWER LINES: 2671
POWERSOLAR: 2
POWERWIND: 1
RAILWAY: 843
ROAD: 5378
ROCK: 744
SHIPWRECK: 4
STACK: 11
TRACK: 12834
TRANSMITTER: 15
TREE: 1881630
VIEW-TOWER: 239
WALL: 4418
WATERTOWER: 7

Weferlingen

BUILDING: 5072
BUSH: 731315
BUSSTOP: 106
CHAPEL: 13
CHURCH: 21
FENCE: 83908
FUELSTATION: 9
HIDE: 231818
HOUSE: 4562
MAIN ROAD: 1535
POWER LINES: 1958
RAILWAY: 2324
ROAD: 8740
STACK: 18
TRACK: 24372
TRANSMITTER: 1
TREE: 829449
VIEW-TOWER: 34

Weferlingen (Winter)

BUILDING: 5072
BUSH: 519827
BUSSTOP: 106
CHAPEL: 13
CHURCH: 21
FENCE: 83908
FUELSTATION: 9
HIDE: 229792
HOUSE: 4562
MAIN ROAD: 1535
POWER LINES: 1958
RAILWAY: 2324
ROAD: 8740
STACK: 18
TRACK: 24372
TRANSMITTER: 1
TREE: 829449
VIEW-TOWER: 34

Cam Lao Nam

BUILDING: 390
BUNKER: 2622
BUSH: 1852844
CHURCH: 6
FENCE: 12346
FORTRESS: 2
FOUNTAIN: 3
FUELSTATION: 32
HIDE: 309385
HOUSE: 13319
LIGHTHOUSE: 3
MAIN ROAD: 4162
POWER LINES: 1591
POWERSOLAR: 5
POWERWIND: 5
RAILWAY: 1345
ROAD: 17621
ROCK: 60452
SHIPWRECK: 161
TOURISM: 18
TRACK: 6846
TRAIL: 7726
TRANSMITTER: 33
TREE: 1442842
VIEW-TOWER: 529
WALL: 19664
WATERTOWER: 32

Khe Sanh

BUILDING: 91
BUNKER: 4861
BUSH: 1299130
FENCE: 2196
FOUNTAIN: 2
FUELSTATION: 3
HIDE: 228731
HOUSE: 5754
POWER LINES: 801
ROAD: 7755
ROCK: 33853
TRACK: 8156
TRANSMITTER: 3
TREE: 1145377
VIEW-TOWER: 227
WALL: 9078
WATERTOWER: 13

The Bra

BUILDING: 8
BUNKER: 265
BUSH: 179428
FENCE: 251
HIDE: 56960
HOUSE: 522
POWER LINES: 25
ROAD: 7
ROCK: 671
SHIPWRECK: 2
TRACK: 584
TRAIL: 2767
TRANSMITTER: 1
TREE: 203443
VIEW-TOWER: 48
WALL: 2076

Gabreta

BUILDING: 222
BUSH: 383449
BUSSTOP: 18
CHAPEL: 10
CHURCH: 11
CROSS: 17
FENCE: 25616
FORTRESS: 149
FOUNTAIN: 2
FUELSTATION: 11
HIDE: 582635
HOSPITAL: 1
HOUSE: 6352
MAIN ROAD: 4427
POWER LINES: 502
POWERSOLAR: 2
RAILWAY: 1923
ROAD: 8693
ROCK: 918
RUIN: 5
SHIPWRECK: 1
STACK: 6
TRACK: 10066
TRAIL: 1170
TRANSMITTER: 2
TREE: 3473175
VIEW-TOWER: 39
WALL: 6218
WATERTOWER: 8

Sefrou-Ramal

BUILDING: 2
BUSH: 13669
FENCE: 5199
FUELSTATION: 2
HIDE: 23243
HOUSE: 1963
MAIN ROAD: 403
POWER LINES: 565
POWERWIND: 19
RAILWAY: 135
ROAD: 199
ROCK: 1183
TRACK: 3286
TRANSMITTER: 9
TREE: 7592
WALL: 3560
WATERTOWER: 2

Spearhead 1944 Normandy

BUILDING: 2918
BUNKER: 1703
BUSH: 608441
CHURCH: 45
CROSS: 16
FENCE: 288630
FORTRESS: 196
FOUNTAIN: 1286
HIDE: 330656
HOUSE: 12837
MAIN ROAD: 1981
RAILWAY: 776
ROAD: 20237
ROCK: 837
RUIN: 1
SMALL TREE: 20
TRACK: 29761
TRAIL: 6365
TREE: 581549
VIEW-TOWER: 95
WALL: 60793
WATERTOWER: 34

ⓘ

Extraction script can be found on the Biki Export Scripts page.

↑ Back to spoiler's top

Groups:

Object Detection

Syntax

Syntax:: nearestTerrainObjects [position, types, radius, sort, 2Dmode]
Parameters:: position: Object, PositionAGL or Position2D - where to find objects, center position
: types: Array - list of case-insensitive types of the objects to search for. [] to search without filters
: radius: Number - range from center position to search for objects
since 1.62: sort: Boolean - (Optional, default true) sort objects by distance to the center or not - setting to false greatly improves performance
since 1.66: 2Dmode: Boolean - (Optional, default false) the object search and sorting mode: true - 2D, false - 3D
Return Value:: Array - array of terrain objects. Before Arma 3 v2.00 this command did not return roads of type "ROAD", "MAIN ROAD", "TRACK", "TRAIL"

Examples

Example 1:: nearestTerrainObjects [player, ["Tree", "Bush"], 200];
Example 2:: nearestTerrainObjects [player, ["House"], 200];
Example 3:: nearestTerrainObjects [[2716, 2949, 0], ["Chapel", "Fuelstation"], 100];
Example 4:: Return every terrain object in 50 metres radius around player sorted, closest first:
nearestTerrainObjects [player, [], 50];
Example 5:: Return every terrain object in 50 metres radius around player unsorted:
nearestTerrainObjects [player, [], 50, false];
Example 6:: Hide all terrain objects nearestTerrainObjects could find:
if (isServer) then { private _allTerrainObjects = nearestTerrainObjects [ [worldSize / 2, worldSize / 2], [], worldSize * sqrt 2 / 2, false ]; { _x hideObjectGlobal true } forEach _allTerrainObjects; };

Additional Information

See also:: nearestObjects findNearestEnemy hideObject nearestBuilding nearestObject nearObjects nearestLocation nearEntities nearTargets nearSupplies nearestLocationWithDubbing nearObjectsReady nearRoads roadsConnectedTo roadAt isOnRoad getRoadInfo nearestMines

Notes

: Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

Killzone_Kid - c: Posted on Oct 31, 2016 - 00:20 (UTC)
: Since Arma 3 v1.66 the default sorting is done according to 3D distance not distance2D as before. This is an attempt to correct some very old bug in implementation.

Demellion - c: Posted on Dec 28, 2016 - 20:21 (UTC)
: Be aware that some terrain objects types might be tricky to be found, such as terrain rocks and boulders which are not considered to be "ROCKS" or "ROCK", but "HIDE". Example:
nearestTerrainObjects [player, ["HIDE"], 20]; // [939688: bluntstone_01.p3d,939691: garbagebags_f.p3d,939671: wreck_car_f.p3d,939692: junkpile_f.p3d]

Killzone_Kid - c: Posted on Jun 07, 2020 - 14:16 (UTC)
: Large bridges are map type "ROAD". Small foot bridges are not roads and not included into road net.