Installation

Follow these steps to install the script correctly on GTA 5.

Requirements

• A working FiveM server (local or hosted) with OneSync enabled.
• Access to the server files (via FTP or directly on your machine).

Installation steps

1. Download the script
   Get the script folder (usually in .zip or .rar format) from the official source.

2. Extract the folder
   Use a tool like WinRAR or 7-Zip to extract the script folder on your computer.

3. Place the folder in the resources directory
   Copy the script folder into the resources folder of your FiveM server (for example: resources/[myserver]/intense_smoke_grenade).
   ⚠️ Do not rename the folder: the name intense_smoke_grenade is used by the item export.

4. Declare the script in the server.cfg file
   Open the server.cfg file at the root of your server and add the following line: ensure intense_smoke_grenade
   If you use ox_inventory, place this line after ensure ox_inventory.

5. Configure the script
   Edit the shared/config.lua configuration file to suit your needs before starting the server. (See Configuration)

6. Add the item to your inventory

   • With ox_inventory: add the following item to ox_inventory/data/items.lua:

     ['intense_smoke_grenade'] = {
         label = 'Intense smoke bomb',
         weight = 500,
         stack = true,
         close = true,
         description = 'Smoke bomb to place on the ground, detonated remotely.',
         server = {
             export = 'intense_smoke_grenade.intense_smoke_grenade'
         }
     },

     The item name must be identical to Config.Inventory.item in shared/config.lua. The export follows the format intense_smoke_grenade.<item name>.

   • Without ox_inventory: set Config.Inventory.enabled to false. Bombs are then handled by the script’s internal stock (/givesmokebomb command) or by the server exports (see Important functions and variables).

7. Allow the admin command (internal stock only)
   Add to your server.cfg: add_ace group.admin command.givesmokebomb allow

8. Restart the server
   Fully restart your FiveM server so the script, the 3D model and the .meta files are loaded.

---

Tips

• Make sure the script folder contains an fxmanifest.lua file: it is required for FiveM to recognize the script.