Configuration

Le script propose plusieurs options de configuration pour s’adapter à votre serveur FiveM.
Vous pouvez modifier ces paramètres pour ajuster les fonctionnalités selon vos besoins.

Fichier de configuration

• Le fichier de configuration se trouve dans le dossier shared, sous le nom config.lua.
• Ouvrez ce fichier avec un éditeur de texte (comme Notepad++, Visual Studio Code ou même un bloc-note 😜).

Paramètres principaux

Voici les paramètres que vous pouvez personnaliser :

Config = {}

-- ============================================================
-- General
-- ============================================================
Config.Debug  = false
Config.Locale = 'en'  -- fr, en, de, es

-- ============================================================
-- Notifications
-- ============================================================
Config.Notifications = {
    enabled   = true,
    provider  = 'auto', -- 'auto', 'default', 'mythic_notify', 'wasabi_notify', 'noxen_notify', 'okokNotify'
    placing   = true,
    placed    = true,
    activated = true,
    ended     = true,
    expired   = true,
    errors    = true,
}

-- ============================================================
-- Keys
-- ============================================================
Config.Keys = {
    place    = { command = 'smokebomb_place',    key = 'K' },
    detonate = { command = 'smokebomb_detonate', key = 'G' },
}

-- ============================================================
-- Behaviour
-- ============================================================
Config.MaxBombsPerPlayer = 5
Config.DetonateRadius    = 80.0
Config.DetonateOnlyOwn   = true
Config.PlaceCooldown     = 2
Config.DetonateCooldown  = 2
Config.PlaceDistance     = 0.7
Config.MaxPlaceDistance  = 3.0

Config.SmokeDuration     = 25
Config.AutoDeleteTime    = 300

-- ============================================================
-- Stock (optional, standalone)
-- ============================================================
Config.Stock = {
    enabled     = true,
    giveCommand = 'givesmokebomb',
}

-- ============================================================
-- Inventory item
-- ============================================================
Config.Inventory = {
    enabled  = true,
    resource = 'ox_inventory',
    item     = 'intense_smoke_grenade',
}

-- ============================================================
-- Prop
-- ============================================================
Config.Prop = {
    model   = 'intense_smoke_grenade',
    zOffset = 0.0,
}

-- ============================================================
-- Animations
-- ============================================================
Config.PlaceAnim = {
    dict     = 'pickup_object',
    name     = 'pickup_low',
    duration = 1200,
    placeAt  = 750,
    flags    = 0,
}

Config.DetonateAnim = {
    enabled  = true,
    dict     = 'anim@mp_player_intmenu@key_fob@',
    name     = 'fob_click',
    duration = 1000,
    flags    = 48,
    delay    = 300,
}

-- ============================================================
-- Smoke
-- ============================================================
Config.Smoke = {
    grenadeExplosion = true,
    explosionType    = 20,
    stagger          = 250,

    ptfx = {
        enabled = true,
        asset   = 'core',
        name    = 'exp_grd_grenade_smoke',
        offset  = { x = 0.0, y = 0.0, z = 0.1 },
        scale   = 1.0,
        color   = nil, -- e.g. { r = 255, g = 50, b = 50 }
    },
}

-- ============================================================
-- UI sounds
-- ============================================================
Config.Sounds = {
    Place    = { enabled = true, name = 'Bomb_Plant', set = 'FBI_05_SOUNDS' },
    Detonate = { enabled = true, name = 'Beep_Red',   set = 'DLC_HEIST_HACKING_SNAKE_SOUNDS' },
}

Général

• Debug : Activer le mode débogage (true/false). Si vrai, les messages de débogage sont affichés en console (client + serveur).
• Locale : Langue utilisée pour les messages (fr, en, de, es).

Notifications

• enabled : Activer ou désactiver toutes les notifications (les logs de débogage sont conservés).
• provider : Système de notification à utiliser. auto détecte automatiquement mythic_notify, wasabi_notify, noxen_notify ou okokNotify, sinon utilise la notification native de GTA (default).
• placing / placed / activated / ended / expired / errors : Activer ou désactiver chaque type de notification individuellement (pose en cours, pose réussie, bombes activées, fin de la fumée, bombe expirée, erreurs).

Touches

• place / detonate : Commande et touche par défaut pour poser et déclencher les bombes. Mettez key = '' pour ne pas assigner de touche par défaut. Les joueurs peuvent les réassigner dans les paramètres FiveM.

Comportement

• MaxBombsPerPlayer : Nombre maximal de bombes posées en même temps par joueur.
• DetonateRadius : Rayon (en mètres) autour du joueur dans lequel les bombes sont déclenchées.
• DetonateOnlyOwn : Si true, un joueur ne peut déclencher que ses propres bombes.
• PlaceCooldown : Temps (en secondes) entre deux poses, vérifié côté serveur.
• DetonateCooldown : Temps (en secondes) entre deux déclenchements, vérifié côté serveur.
• PlaceDistance : Distance devant le joueur à laquelle la bombe est posée.
• MaxPlaceDistance : Distance maximale autorisée par le serveur entre le joueur et la bombe lors de la pose (anti-triche).
• SmokeDuration : Durée de la fumée en secondes. La bombe est supprimée ensuite.
• AutoDeleteTime : Une bombe jamais déclenchée est supprimée après X secondes (0 = jamais).

Stock interne

• enabled : Si true, le joueur doit posséder des bombes en stock (données via la commande admin ou l’export AddBombs). Si false, la pose est illimitée. Ignoré lorsque l’item d’inventaire est actif.
• giveCommand : Nom de la commande admin pour donner des bombes (/givesmokebomb [id] [quantité]).

Item d’inventaire

• enabled : Utiliser un item d’inventaire (prioritaire sur le stock interne lorsque la ressource d’inventaire est démarrée).
• resource : Nom de la ressource d’inventaire (ox_inventory).
• item : Nom de l’item. Il doit être identique au nom déclaré dans votre inventaire.

Modèle 3D

• model : Nom du modèle de la bombe (fourni dans stream/). Modèle vanilla de secours : prop_bomb_01.
• zOffset : Ajustement vertical si le modèle s’enfonce dans le sol ou flotte au-dessus.

Animations

• PlaceAnim : Animation de pose (dictionnaire, nom, durée en ms, placeAt = moment où la bombe apparaît au sol).
• DetonateAnim : Animation de la télécommande (flags = 48 = haut du corps uniquement, delay = délai en ms avant l’envoi du déclenchement).

Fumée

• grenadeExplosion : Utiliser l’explosion native de grenade fumigène (son et fumée synchronisés pour tous les joueurs).
• explosionType : Type d’explosion (20 = grenade fumigène).
• stagger : Délai (en ms) entre l’activation de chaque bombe, pour éviter que le jeu ignore des explosions simultanées.
• ptfx : Fumée supplémentaire (particules) maintenue pendant SmokeDuration pour épaissir l’écran de fumée : asset, nom, décalage, taille (scale) et couleur (color, ex. { r = 255, g = 50, b = 50 } pour une fumée rouge).

Sons

• Place / Detonate : Sons d’interface joués lors de la pose et du déclenchement (nom et set du son GTA). Le son de la fumée est celui de la grenade.

Conseils

• Après chaque modification du fichier de configuration, redémarrez le script ou le serveur pour que les changements soient pris en compte.
• Si un paramètre n’est pas reconnu, vérifiez qu’il est bien orthographié et placé dans la bonne section du fichier.