Configuración

El script ofrece varias opciones de configuración para adaptarse a tu servidor FiveM.
Puedes modificar estos parámetros para ajustar las funcionalidades 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

Estos son los parámetros que puedes personalizar:

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' },
}

General

• Debug: Activar el modo de depuración (true/false). Si es verdadero, los mensajes de depuración se muestran en la consola (cliente + servidor).
• Locale: Idioma utilizado para los mensajes (fr, en, de, es).

Notificaciones

• enabled: Activar o desactivar todas las notificaciones (los logs de depuración se conservan).
• provider: Sistema de notificaciones a utilizar. auto detecta automáticamente mythic_notify, wasabi_notify, noxen_notify u okokNotify; si no, usa la notificación nativa de GTA (default).
• placing / placed / activated / ended / expired / errors: Activar o desactivar cada tipo de notificación por separado (colocación en curso, colocación correcta, bombas activadas, fin del humo, bomba caducada, errores).

Teclas

• place / detonate: Comando y tecla por defecto para colocar y detonar las bombas. Pon key = '' para no asignar ninguna tecla por defecto. Los jugadores pueden reasignarlas en los ajustes de FiveM.

Comportamiento

• MaxBombsPerPlayer: Número máximo de bombas colocadas a la vez por jugador.
• DetonateRadius: Radio (en metros) alrededor del jugador dentro del cual se detonan las bombas.
• DetonateOnlyOwn: Si es true, un jugador solo puede detonar sus propias bombas.
• PlaceCooldown: Tiempo (en segundos) entre dos colocaciones, comprobado en el servidor.
• DetonateCooldown: Tiempo (en segundos) entre dos detonaciones, comprobado en el servidor.
• PlaceDistance: Distancia delante del jugador a la que se coloca la bomba.
• MaxPlaceDistance: Distancia máxima permitida por el servidor entre el jugador y la bomba al colocarla (anti-trampas).
• SmokeDuration: Duración del humo en segundos. Después, la bomba se elimina.
• AutoDeleteTime: Una bomba que nunca se detona se elimina tras X segundos (0 = nunca).

Stock interno

• enabled: Si es true, el jugador debe tener bombas en stock (entregadas con el comando de administrador o el export AddBombs). Si es false, la colocación es ilimitada. Se ignora cuando el ítem de inventario está activo.
• giveCommand: Nombre del comando de administrador para dar bombas (/givesmokebomb [id] [cantidad]).

Ítem de inventario

• enabled: Usar un ítem de inventario (tiene prioridad sobre el stock interno cuando el recurso de inventario está iniciado).
• resource: Nombre del recurso de inventario (ox_inventory).
• item: Nombre del ítem. Debe ser idéntico al nombre declarado en tu inventario.

Modelo 3D

• model: Nombre del modelo de la bomba (incluido en stream/). Modelo vanilla de respaldo: prop_bomb_01.
• zOffset: Ajuste vertical si el modelo se hunde en el suelo o flota por encima.

Animaciones

• PlaceAnim: Animación de colocación (diccionario, nombre, duración en ms, placeAt = momento en que la bomba aparece en el suelo).
• DetonateAnim: Animación del mando a distancia (flags = 48 = solo la parte superior del cuerpo, delay = retraso en ms antes de enviar la detonación).

Humo

• grenadeExplosion: Usar la explosión nativa de granada de humo (sonido y humo sincronizados para todos los jugadores).
• explosionType: Tipo de explosión (20 = granada de humo).
• stagger: Retraso (en ms) entre la activación de cada bomba, para evitar que el juego ignore explosiones simultáneas.
• ptfx: Humo adicional (partículas) mantenido durante SmokeDuration para espesar la cortina de humo: asset, nombre, desplazamiento, tamaño (scale) y color (color, p. ej. { r = 255, g = 50, b = 50 } para un humo rojo).

Sonidos

• Place / Detonate: Sonidos de interfaz que se reproducen al colocar y al detonar (nombre y set del sonido de GTA). El sonido del humo es el de la granada.

Consejos

• Después de cada modificación del archivo de configuración, reinicia el script o el servidor para que se apliquen los cambios.
• Si un parámetro no se reconoce, comprueba que está bien escrito y colocado en la sección correcta del archivo.