Конфигурация

Скрипт предлагает несколько параметров конфигурации, чтобы адаптироваться к вашему серверу FiveM.
Вы можете изменить эти параметры, чтобы настроить функции под свои нужды.

Файл конфигурации

• Файл конфигурации находится в папке shared и называется config.lua.
• Откройте этот файл в текстовом редакторе (например, Notepad++, Visual Studio Code или даже Блокнот 😜).

Основные параметры

Вот параметры, которые вы можете настроить:

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

Общие

• Debug: Включить режим отладки (true/false). Если включён, отладочные сообщения выводятся в консоль (клиент + сервер).
• Locale: Язык сообщений (fr, en, de, es).

Уведомления

• enabled: Включить или отключить все уведомления (отладочные логи сохраняются).
• provider: Используемая система уведомлений. auto автоматически определяет mythic_notify, wasabi_notify, noxen_notify или okokNotify, иначе используется нативное уведомление GTA (default).
• placing / placed / activated / ended / expired / errors: Включить или отключить каждый тип уведомлений отдельно (идёт установка, установка успешна, бомбы активированы, дым рассеялся, бомба истекла, ошибки).

Клавиши

• place / detonate: Команда и клавиша по умолчанию для установки и подрыва бомб. Укажите key = '', чтобы не назначать клавишу по умолчанию. Игроки могут переназначить их в настройках FiveM.

Поведение

• MaxBombsPerPlayer: Максимальное количество одновременно установленных бомб на игрока.
• DetonateRadius: Радиус (в метрах) вокруг игрока, в котором подрываются бомбы.
• DetonateOnlyOwn: Если true, игрок может подрывать только свои бомбы.
• PlaceCooldown: Время (в секундах) между двумя установками, проверяется на сервере.
• DetonateCooldown: Время (в секундах) между двумя подрывами, проверяется на сервере.
• PlaceDistance: Расстояние перед игроком, на котором устанавливается бомба.
• MaxPlaceDistance: Максимальное расстояние между игроком и бомбой при установке, разрешённое сервером (анти-чит).
• SmokeDuration: Длительность дыма в секундах. После этого бомба удаляется.
• AutoDeleteTime: Бомба, которую так и не подорвали, удаляется через X секунд (0 = никогда).

Внутренний запас

• enabled: Если true, у игрока должны быть бомбы в запасе (выдаются командой администратора или экспортом AddBombs). Если false, установка не ограничена. Игнорируется, когда активен предмет инвентаря.
• giveCommand: Название команды администратора для выдачи бомб (/givesmokebomb [id] [количество]).

Предмет инвентаря

• enabled: Использовать предмет инвентаря (имеет приоритет над внутренним запасом, если ресурс инвентаря запущен).
• resource: Название ресурса инвентаря (ox_inventory).
• item: Имя предмета. Оно должно совпадать с именем, объявленным в вашем инвентаре.

3D-модель

• model: Название модели бомбы (находится в stream/). Запасная ванильная модель: prop_bomb_01.
• zOffset: Вертикальная корректировка, если модель проваливается в землю или парит над ней.

Анимации

• PlaceAnim: Анимация установки (словарь, имя, длительность в мс, placeAt = момент появления бомбы на земле).
• DetonateAnim: Анимация пульта (flags = 48 = только верхняя часть тела, delay = задержка в мс перед отправкой подрыва).

Дым

• grenadeExplosion: Использовать нативный взрыв дымовой гранаты (звук и дым синхронизированы для всех игроков).
• explosionType: Тип взрыва (20 = дымовая граната).
• stagger: Задержка (в мс) между активацией каждой бомбы, чтобы игра не пропускала одновременные взрывы.
• ptfx: Дополнительный дым (частицы), сохраняющийся в течение SmokeDuration для более плотной завесы: asset, имя, смещение, размер (scale) и цвет (color, например { r = 255, g = 50, b = 50 } для красного дыма).

Звуки

• Place / Detonate: Звуки интерфейса при установке и подрыве (имя и набор звука GTA). Звук дыма — это звук гранаты.

Советы

• После каждого изменения файла конфигурации перезапустите скрипт или сервер, чтобы изменения вступили в силу.
• Если параметр не распознаётся, проверьте его написание и расположение в нужном разделе файла.