Configuración

El script ofrece varias opciones de configuración para adaptarse a tu servidor FiveM. Puedes modificar estos parámetros para ajustar las funciones según tus necesidades.

Archivo de configuración

• El archivo de configuración se encuentra en la carpeta shared, con el nombre config.lua.
• Abre este archivo con un editor de texto (como Notepad++, Visual Studio Code o incluso el bloc de notas 😜).

Parámetros principales

Aquí están los parámetros que puedes personalizar:

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.SendNotification = true

Config.NotifyTitle = "Laugh Grenade"

Config.NotifyDuration = 5000

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

Config.CustomNotify = function(message, nType, duration)
    -- Example with your own export:
    -- exports['my_notify']:ShowNotification(Config.NotifyTitle, message, nType, duration)

    -- Default fallback: GTA help text
    BeginTextCommandDisplayHelp("STRING")
    AddTextComponentSubstringPlayerName(message)
    EndTextCommandDisplayHelp(0, false, true, duration)
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: Activa el modo de depuración (true/false). Si es true, los mensajes de depuración se mostrarán en la consola.

• Locale: Idioma usado para los mensajes (por ejemplo, “fr” para francés).

• WeaponName: Nombre del arma de la granada divertida.

• AmmoName: Nombre de la munición de la granada divertida.

• GrenadeActivationDelay: Retardo de activación de la granada después de lanzarla (en milisegundos).

• GrenadeRange: Radio de efecto de la granada (en metros).

• GasDuration: Duración del efecto de gas (en milisegundos).

• EffectDuration: Duración de las animaciones divertidas en los jugadores afectados (en milisegundos).

• EffectCheckInterval: Intervalo de comprobación de los jugadores afectados para aplicar las animaciones (en milisegundos).

• MaxThrowDistance: Distancia máxima a la que se puede lanzar la granada (en metros).

• DisableWeapons: Deshabilitar las armas de los jugadores afectados durante la duración del efecto (true/false).

• EnableMaskImmunity: Activar inmunidad para los jugadores que usan ciertas máscaras (true/false).

• ImmunityMasks: Lista de máscaras que otorgan inmunidad a la granada divertida, definidas por sus IDs de drawable.

• LaughAnimations: Lista de animaciones de risa (elegidas al azar) para aplicar a los jugadores afectados, definida por su diccionario y nombre de animación.

• ParticleDict: Diccionario de partículas usado para los efectos visuales de la granada.

• ParticleName: Nombre de la partícula usada para los efectos visuales de la granada.

• SendNotification: Activar el envío de notificaciones (true/false).

• NotifyTitle: Título mostrado en las notificaciones (cuando lo admite el sistema de notificaciones).

• NotifyDuration: Duración predeterminada de las notificaciones en milisegundos.

• Notify: Sistema de notificaciones a usar. El script detecta automáticamente algunos sistemas populares (mythic_notify, k5_notify, FL-Notify, dillen-notifications, noxen_notify, wasabi_notify). Si no se encuentra ninguno, usa el sistema predeterminado.

• SoundSystem: Sistema de sonido a usar. El script detecta automáticamente algunos sistemas populares (xsound, interact-sound, evo_sound). Si no se encuentra ninguno, usa un sistema personalizado. Establece el valor en “custom” para usar la configuración personalizada en Config.Sound.

• Sound: Configuración de sonido personalizada (si SoundSystem está establecido en “custom”).

  • url: URL del archivo de audio a reproducir (debe ser un enlace directo a un archivo de audio compatible o una URL de YouTube).
  • volume: Volumen del sonido (valor entre 0.0 y 1.0).

Consejos

• Después de cada modificación del archivo de configuración, reinicia el script o el servidor para que los cambios surtan efecto.
• Si un parámetro no se reconoce, asegúrate de que esté escrito correctamente y ubicado en la sección correcta del archivo.