---
name: "BIS_fnc_ambientBlacklist"
type: function
status: ok
groups: ["Ambient", "Positions"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_ambientBlacklist
revid: 349062
updated: 2023-11-08T14:47:20Z
---

# BIS_fnc_ambientBlacklist

*Function · Ambient, Positions · Arma 3 v0.50 · introduced in Take On Helicopters v1.00*

## Description

Check if area is blacklisted. Blacklist triggers are to be named 'bis_ambientBlacklist_#', where # is number from 0 to 99.

## Syntax

```sqf
[input] call BIS_fnc_ambientBlacklist
```

**Parameters:**

- `input`: [Array](../topics/Array.md) - if array, function checks if givin position is in blacklisted areas. If any [Number](../topics/Number.md) is passed to the function instead of an [Array](../topics/Array.md) blacklisted areas are initialized and saved in BIS_ambientBlacklist

**Returns:** [Boolean](../topics/Boolean.md) - returns [Boolean](../topics/Boolean.md) when in blacklisted area, when initialization was triggered, it returns [nil](../commands/nil.md)

## Examples

### Example 1

```sqf
[1337,1337,0] call BIS_fnc_ambientBlacklist;
```

### Example 2

```sqf
[0] call BIS_fnc_ambientBlacklist;
```

## See also

[BIS_fnc_ambientBlacklistAdd](../functions/BIS_fnc_ambientBlacklistAdd.md)

<sub>Source: [BI Community Wiki — BIS fnc ambientBlacklist](https://community.bistudio.com/wiki/BIS_fnc_ambientBlacklist) (revision 349062).</sub>