Configuration

The script offers several configuration options to adapt to your FiveM server.
You can modify these settings to adjust features according to your needs.

Configuration file

• The configuration file is located in the shared folder, named config.lua.
• Open this file with a text editor (such as Notepad++, Visual Studio Code, or even Notepad 😜).

Main settings

Here are the settings you can customize:

Config = {}

Config.Debug = false
Config.Locale = "fr"
Config.Key = "G"

-- ================================================================
-- NOTIFICATIONS
-- ================================================================

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

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

-- ================================================================
-- SOUND CONFIGURATION
-- ================================================================

Config.SoundName = "emp"
Config.SoundmaxDistance = 20.0
Config.MaxVolume = 0.1

if Config.Debug then
  print("[IEM] Sound configured: " .. Config.SoundName .. ".ogg")
end

-- ================================================================
-- EMP EFFECT CONFIGURATION
-- ================================================================

Config.EmpRange = 15.0
Config.EmpTimer = 10
Config.MaxDetonationDistance = 100.0
Config.DetonationCooldown = 5
Config.ExplosionID = 36

-- ================================================================
-- VISUAL EFFECTS CONFIGURATION
-- ================================================================

Config.UseParticleEffects = true
Config.ParticleDict = "veh_xs_vehicle_mods"
Config.ParticleName = "exp_xs_mine_emp"
Config.ParticleScale = 5.0
Config.ParticleDuration = 3000

-- ================================================================
-- PERFORMANCE & LIMITS
-- ================================================================

Config.MaxActiveObjects = 30
Config.MaxStickiesPerPlayer = 15
Config.ObjectCleanupInterval = 45
Config.ServerCleanupInterval = 90
Config.ObjectLifetime = 600
Config.FlyingObjectTimeout = 60
Config.StickyLifetime = 900

-- ================================================================
-- VEHICLE ATTACHMENT CONFIGURATION
-- ================================================================

Config.searchForVehicleRange = 4
Config.BIGVEHICLECLASSES = {15, 16, 20}
Config.BIGRangeMultiplier = 1.5

Config.StickyBoneConfig = {
    [0] = { -- Compacts
        order = {"platelight", "bonnet", "boot", "chassis", "chassis_dummy"},
        bones = {
            platelight    = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 90.0, -90.0) },
            bonnet        = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
            boot          = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
            chassis       = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
            chassis_dummy = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
        }
    },
    [8] = { -- Motorcycles
        order = {"chassis", "chassis_dummy", "boot"},
        bones = {
            chassis       = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
            chassis_dummy = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
            boot          = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
            taillight_l   = { offset = vector3(0.048, 0.0, 0.0), rotation = vector3(0.0, 90.0, -90.0) },
            taillight_r   = { offset = vector3(-0.048, 0.0, 0.0), rotation = vector3(0.0, 90.0, -90.0) },
        }
    },
    [15] = { -- Helicopters
        order = {"chassis", "chassis_dummy"},
        bones = {
            chassis       = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
            chassis_dummy = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
        }
    },
    [16] = { -- Planes
        order = {"boot", "chassis", "bonnet"},
        bones = {
            boot          = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
            chassis       = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
            bonnet        = { offset = vector3(0.0, 0.050, 0.0), rotation = vector3(0.0, 90.0, 90.0) },
        }
    },
    [20] = { -- Commercial trucks
        order = {"boot", "chassis", "bonnet"},
        bones = {
            boot          = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 90.0, -90.0) },
            chassis       = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
            bonnet        = { offset = vector3(0.0, 0.050, 0.0), rotation = vector3(0.0, 90.0, 90.0) },
        }
    },

    -- Default configuration for unconfigured vehicle classes
    default = {
        order = {
            "platelight", "bonnet", "boot", "bumper_f", "bumper_r",
            "headlight", "taillight_l", "taillight_r", "chassis", "chassis_dummy"
        },
        bones = {
            platelight    = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 90.0, -90.0) },
            bonnet        = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
            boot          = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
            bumper_f      = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
            bumper_r      = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
            headlight     = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
            taillight_l   = { offset = vector3(0.048, 0.0, 0.0), rotation = vector3(0.0, 90.0, -90.0) },
            taillight_r   = { offset = vector3(-0.048, 0.0, 0.0), rotation = vector3(0.0, 90.0, -90.0) },
            chassis       = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
            chassis_dummy = { offset = vector3(0.0, 0.0, 0.0), rotation = vector3(0.0, 0.0, 0.0) },
        }
    }
}

• Debug: Enable debug mode (true/false). If true, debug messages will be printed to the console.

• Locale: Language used for messages (e.g. “fr” for French).

• Key: Key to activate the sticky jammer

• SendNotification: Enable notifications (true/false).

• Notify: Notification system to use (default: mythic_notify, k5_notify, etc.).

• SoundName: Name of the sound file used on activation.

• SoundmaxDistance: Maximum distance at which the sound can be heard.

• MaxVolume: Maximum sound volume (0.0 to 1.0).

• EmpRange: Range of the explosion effect in meters.

• EmpTimer: Duration of the jamming effect in seconds.

• MaxDetonationDistance: Maximum distance between the player and the target for the detonation to be effective.

• DetonationCooldown: Detonation cooldown time (in seconds) — time required before the player can trigger another detonation.

• ExplosionID: Type of explosion used (numeric ID).

• UseParticleEffects: Enable visual effects (true/false).

• ParticleDict: Particle dictionary used for the visual effect

• ParticleName: Name of the particle used for the visual effect

• ParticleScale: Particle scale (size).

• ParticleDuration: Duration of the visual effect in milliseconds.

• MaxActiveObjects: Maximum number of active sticky bombs per client

• MaxStickiesPerPlayer: Maximum number of sticky bombs per player (server-side)

• ObjectCleanupInterval: Automatic cleanup interval in seconds (client-side)

• ServerCleanupInterval: Automatic cleanup interval in seconds (server-side)

• ObjectLifetime: Maximum lifetime of an object in seconds (10 minutes)

• FlyingObjectTimeout: Timeout for flying objects in seconds

• StickyLifetime: Maximum lifetime of placed stickies in seconds (15 minutes)

• searchForVehicleRange: Detection range for attaching to vehicles (in meters)

• BIGVEHICLECLASSES: Vehicle categories with increased detection range (helicopters, planes, commercial trucks). Mainly for large vehicles because their entity detection hitbox does not cover the whole vehicle.

• StickyBoneConfig: Bone attachment configuration per vehicle class. The order defines the priority for bone search.

Tips

• After each change to the configuration file, restart the script or the server for the changes to take effect.
• If a setting is not recognized, check that it is spelled correctly and placed in the correct section of the file.