# FIRE::ADD_EXPLOSION

- **Hash:** `0x7D6F58F69DA92530`
- **Namespace:** FIRE
- **Runtime name (Lua/JS):** `AddExplosion`
- **Side:** client (game native)
- **Name status:** official
- **Documentation:** described
- **Since game build:** 1207
- **URL:** https://natives.borderlinerp.com/natives/FIRE/ADD_EXPLOSION

## Signature

```c
void ADD_EXPLOSION(float x, float y, float z, int explosionType, float damageScale, BOOL isAudible, BOOL isInvisible, float cameraShake);
```

## Parameters

- `x` (`float`)
- `y` (`float`)
- `z` (`float`)
- `explosionType` (`int`)
- `damageScale` (`float`)
- `isAudible` (`BOOL`)
- `isInvisible` (`BOOL`)
- `cameraShake` (`float`)

## Returns

`void`

## Description

https://github.com/femga/rdr3_discoveries/tree/master/graphics/explosions

explosionType:
enum eExplosionTag
{
	EXP_TAG_DONTCARE = -1,
	EXP_TAG_GRENADE,
	EXP_TAG_STICKYBOMB,
	EXP_TAG_MOLOTOV,
	EXP_TAG_MOLOTOV_VOLATILE,
	EXP_TAG_HI_OCTANE,
	EXP_TAG_CAR,
	EXP_TAG_PLANE,
	EXP_TAG_PETROL_PUMP,
	EXP_TAG_DIR_STEAM,
	EXP_TAG_DIR_FLAME,
	EXP_TAG_DIR_WATER_HYDRANT,
	EXP_TAG_BOAT,
	EXP_TAG_BULLET,
	EXP_TAG_SMOKEGRENADE,
	EXP_TAG_BZGAS,
	EXP_TAG_GAS_CANISTER,
	EXP_TAG_EXTINGUISHER,
	EXP_TAG_TRAIN,
	EXP_TAG_DIR_FLAME_EXPLODE,
	EXP_TAG_VEHICLE_BULLET,
	EXP_TAG_BIRD_CRAP,
	EXP_TAG_FIREWORK,
	EXP_TAG_TORPEDO,
	EXP_TAG_TORPEDO_UNDERWATER,
	EXP_TAG_LANTERN,
	EXP_TAG_DYNAMITE,
	EXP_TAG_DYNAMITESTACK,
	EXP_TAG_DYNAMITE_VOLATILE,
	EXP_TAG_RIVER_BLAST,
	EXP_TAG_PLACED_DYNAMITE,
	EXP_TAG_FIRE_ARROW,
	EXP_TAG_DYNAMITE_ARROW,
	EXP_TAG_PHOSPHOROUS_BULLET,
	EXP_TAG_LIGHTNING_STRIKE,
	EXP_TAG_TRACKING_ARROW,
	EXP_TAG_POISON_BOTTLE
};

## Usage

### Lua

```lua
AddExplosion(x, y, z, explosionType, damageScale, isAudible, isInvisible, cameraShake)

-- always available, by hash
Citizen.InvokeNative(0x7D6F58F69DA92530, x, y, z, explosionType, damageScale, isAudible, isInvisible, cameraShake)
```

### JavaScript

```js
AddExplosion(x, y, z, explosionType, damageScale, isAudible, isInvisible, cameraShake);

// by hash
Citizen.invokeNative('0x7D6F58F69DA92530', x + 0.0000001, y + 0.0000001, z + 0.0000001, explosionType, damageScale + 0.0000001, isAudible, isInvisible, cameraShake + 0.0000001);
```

### C#

```csharp
Function.Call((Hash)0x7D6F58F69DA92530, x, y, z, explosionType, damageScale, isAudible, isInvisible, cameraShake);
```

- Float parameters: Lua integers (`10`, or whole numbers decoded from NUI/JSON) are sent as ints and read as garbage. Write `10.0` or `value + 0.0`. The generated JS wrappers add `0.0000001` to non-zero floats for the same reason.

## Related enums

- [eExplosionTag](https://natives.borderlinerp.com/enums/eExplosionTag.md) — 37 values

*Sources: alloc8or RDR3 NativeDB.*
