---
description: >-
  Script developed for the server LGW⚡WL+18 FR-QC⚡SERIOUS RP✨FPS
  OPTIMIZED✨UNIQUE MAPPING-SCRIPT
---

# Dynamite

### ⚡ First Start

1. Make sure your core/inventory supports the item name set in `Config.ItemName` (default: `kit_dynamite`).
2. For other frameworks, use the provided client/server events to trigger dynamite placement and fire.

***

### 🟦 Client Side

*   **Place dynamite & fire** (Other frameworks):

    ```lua
    TriggerEvent("BTFire:placeFire")
    ```
*   **Manually trigger a fire at coordinates**:

    ```lua
    TriggerEvent("BTFire:placeDynamiteAtCoords", vector3(3288.76, -1282.01, 50.76))
    ```

***

### 🟧 Server Side

*   **Ask a specific player to place dynamite/fire**:

    ```lua
    TriggerClientEvent("BTFire:placeFire", source)
    ```
*   **Manually trigger fire for a player at specific coordinates**:

    ```lua
    TriggerClientEvent("BTFire:placeDynamiteAtCoords", source, vector3(3288.76, -1282.01, 50.76))
    ```

***

### ⚙️ Configuration Highlights (`config.lua`)

* **General**
  * `Config.ItemName` – Name of the inventory item required to place dynamite (VORP only).
  * `Config.DEBUG` – Enables debug mode for easy testing.
* **Prompts & Keys**
  * Customizable prompt texts and keybinds for all main actions (placing, detonating, cancel, water/bucket, etc).
* **Fire Parameters**
  * `Config.AllowOutside`, `Config.FireMinOutside`, `Config.FireMaxOutside`\
    → Number and location of fire sources.
  * `Config.EnableFireSmoke` – Add visible flames and smoke.
  * `Config.AllowExtinguish`, `Config.BucketRadius` – Allow players to extinguish fire with water.
* **Dynamite Parameters**
  * `Config.WireLength` – Length of detonator wire (min 10.0).
  * `Config.ExplodeTime` – Time in seconds before explosion (can be randomized).
  * `Config.ShowCountDown`, `Config.CountDownStyle` – Explosion countdown display options.
* **Discord**
  * Webhook support for explosion logs/alerts.
*   **Text Messages**

    ```lua
    Config.Txt = {
        TooFar = "Warning, you are going too far, the wire might break.",
        TooFarGone = "The wire has broken"
    }
    ```

***

### 📦 Features

* Players can place dynamite, run a detonator via wire, and create a fire that persists until extinguished or server reboot.
* Fire is **extinguishable** with water if allowed in config.
* Compatible with VORP, RedEM, RSGCore and other major frameworks (via notification helpers).
* Multiple fire and smoke effects, adjustable for inside/outside buildings.

***

### 🟧/🟦 Events & Exports

*   **Trigger fire from client:**

    ```lua
    TriggerEvent("BTFire:placeFire")
    TriggerEvent("BTFire:placeDynamiteAtCoords", vector3(x, y, z))
    ```
*   **Trigger fire from server:**

    ```lua
    TriggerClientEvent("BTFire:placeFire", source)
    TriggerClientEvent("BTFire:placeDynamiteAtCoords", source, vector3(x, y, z))
    ```

***

### 📌 Notes

* If you go too far from the detonator wire, it will break and the dynamite won’t explode (`Config.Txt.TooFar`, `Config.Txt.TooFarGone`).
* Fire persists even after explosion until players put it out or the server is restarted.
* All prompts, keybinds, and texts are fully customizable in `config.lua`.
