Installation

Suivez ces étapes pour installer correctement le script sur GTA 5.

Prérequis

• Un serveur FiveM fonctionnel (local ou hébergé) avec OneSync activé.
• Accès aux fichiers du serveur (via FTP ou directement sur votre machine).

Étapes d’installation

1. Téléchargez le script
   Récupérez le dossier du script (souvent au format .zip ou .rar) depuis la source officielle.

2. Décompressez le dossier
   Utilisez un outil comme WinRAR ou 7-Zip pour extraire le dossier du script sur votre ordinateur.

3. Placez le dossier dans le répertoire resources
   Copiez le dossier du script dans le dossier resources de votre serveur FiveM (par exemple : resources/[monserveur]/intense_smoke_grenade).
   ⚠️ Ne renommez pas le dossier : le nom intense_smoke_grenade est utilisé par l’export de l’item.

4. Déclarez le script dans le fichier server.cfg
   Ouvrez le fichier server.cfg à la racine de votre serveur et ajoutez la ligne suivante : ensure intense_smoke_grenade
   Si vous utilisez ox_inventory, placez cette ligne après ensure ox_inventory.

5. Configurez le script
   Modifiez le fichier de configuration shared/config.lua selon vos besoins avant de démarrer le serveur. (Voir Configuration)

6. Ajoutez l’item dans votre inventaire

   • Avec ox_inventory : ajoutez l’item suivant dans ox_inventory/data/items.lua :

     ['intense_smoke_grenade'] = {
         label = 'Grenade fumigène intense',
         weight = 500,
         stack = true,
         close = true,
         description = 'Bombe fumigène à poser au sol, déclenchable à distance.',
         server = {
             export = 'intense_smoke_grenade.intense_smoke_grenade'
         }
     },

     Le nom de l’item doit être identique à Config.Inventory.item dans shared/config.lua. L’export prend la forme intense_smoke_grenade.<nom de l’item>.

   • Sans ox_inventory : passez Config.Inventory.enabled à false. Les bombes sont alors gérées par le stock interne du script (commande /givesmokebomb) ou par les exports serveur (voir Fonctions et variables importantes).

7. Autorisez la commande admin (stock interne uniquement)
   Ajoutez dans votre server.cfg : add_ace group.admin command.givesmokebomb allow

8. Redémarrez le serveur
   Redémarrez complètement votre serveur FiveM pour que le script, le modèle 3D et les fichiers .meta soient pris en compte.

---

Conseils

• Vérifiez que le dossier du script contient bien un fichier fxmanifest.lua : c’est indispensable pour que FiveM reconnaisse le script.