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 = {}

Config.Debug = true
Config.Locale = "fr"

-- ============================================================================
-- GRENADE SETTINGS
-- ============================================================================

Config.WeaponName = 'WEAPON_LAUGHGRENADE'
Config.AmmoName = 'AMMO_LAUGHGRENADE'
Config.GrenadeActivationDelay = 1500
Config.GrenadeRange = 10.0
Config.GasDuration = 30000
Config.EffectDuration = 15000
Config.EffectCheckInterval = 200
Config.MaxThrowDistance = 50.0
Config.DisableWeapons = true

-- ============================================================================
-- IMMUNITY SETTINGS
-- ============================================================================

Config.EnableMaskImmunity = true
Config.ImmunityMasks = {
    drawables = {
        46,  -- Gas Mask
        47,  -- Gas Mask variant
        48,  -- Pilot Mask
        121, -- Hazmat Mask
    },
}

-- ============================================================================
-- LAUGH ANIMATIONS
-- ============================================================================

Config.LaughAnimations = {
    { dict = 'noko@rire', anim = 'clip' },
}

-- ============================================================================
-- PARTICLE EFFECTS
-- ============================================================================

Config.ParticleDict = 'core'
Config.ParticleName = 'exp_grd_bzgas_smoke'

-- ============================================================================
-- NOTIFICATION SYSTEM
-- ============================================================================

Config.Notify = "default"

if GetResourceState("mythic_notify") == "started" then
    Config.Notify = "mythic_notify"
elseif GetResourceState("k5_notify") == "started" then
    Config.Notify = "k5_notify"
elseif GetResourceState("Fl-Notify") == "started" then
    Config.Notify = "Fl-Notify"
elseif GetResourceState("dillen-notifications") == "started" then
    Config.Notify = "dillen-notifications"
elseif GetResourceState("noxen_notify") == "started" then
    Config.Notify = "noxen_notify"
elseif GetResourceState("wasabi_notify") == "started" then
    Config.Notify = "wasabi_notify"
elseif GetResourceState("ox_lib") == "started" then
    Config.Notify = "ox_lib"
end

if Config.Debug then
    print("[DEBUG] Config.Notify: " .. Config.Notify)
end

-- ============================================================================
-- SOUND SYSTEM
-- ============================================================================

Config.SoundSystem = ""

if GetResourceState("xsound") == "started" then
    Config.SoundSystem = "xsound"
elseif GetResourceState("interact-sound") == "started" then
    Config.SoundSystem = "interact_sound"
elseif GetResourceState("evo_sound") == "started" then
    Config.SoundSystem = "evo_sound"
else
    Config.SoundSystem = "custom"
end

if Config.Debug then
    print("[DEBUG] Config.SoundSystem: " .. Config.SoundSystem)
end

Config.Sound = {
    url = "",
    volume = 1,
}

• Debug : Activer le mode débogage (true/false). Si vrai, les messages de débogage seront affichés en console.

• Locale : Langue utilisée pour les messages (ex. “fr” pour français).

• WeaponName : Nom de l’arme de la grenade rigolote.

• AmmoName : Nom de la munition de la grenade rigolote.

• GrenadeActivationDelay : Délai d’activation de la grenade après le lancer (en millisecondes).

• GrenadeRange : Rayon d’effet de la grenade (en mètres).

• GasDuration : Durée de l’effet de gaz (en millisecondes).

• EffectDuration : Durée des animations comiques sur les joueurs affectés (en millisecondes).

• EffectCheckInterval : Intervalle de vérification des joueurs affectés pour appliquer les animations (en millisecondes).

• MaxThrowDistance : Distance maximale à laquelle la grenade peut être lancée (en mètres).

• DisableWeapons : Désactiver les armes des joueurs affectés pendant la durée de l’effet (true/false).

• EnableMaskImmunity : Activer l’immunité pour les joueurs portant certains masques (true/false).

• ImmunityMasks : Liste des masques qui confèrent une immunité à la grenade rigolote, définie par leurs IDs de drawable.

• LaughAnimations : Liste des animations (choix aléatoire) de rire à appliquer aux joueurs affectés, définie par leur dictionnaire et nom d’animation.

• ParticleDict : Dictionnaire de particules utilisé pour les effets visuels de la grenade.

• ParticleName : Nom de la particule utilisée pour les effets visuels de la grenade.

• Notify : Système de notification à utiliser. Le script détecte automatiquement certains systèmes populaires (mythic_notify, k5_notify, FL-Notify, dillen-notifications, noxen_notify, wasabi_notify). Si aucun n’est trouvé, il utilise le système par défaut.

• SoundSystem : Système sonore à utiliser. Le script détecte automatiquement certains systèmes populaires (xsound, interact-sound, evo_sound). Si aucun n’est trouvé, il utilise un système personnalisé.

• Sound : Configuration du son personnalisé (si SoundSystem est défini sur “custom”).

  • url : URL du fichier audio à jouer (doit être un lien direct vers un fichier audio compatible ou une url youtube).
  • volume : Volume du son (valeur entre 0.0 et 1.0).

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.

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.