Konfiguration

Das Skript bietet mehrere Konfigurationsoptionen, um sich an deinen FiveM-Server anzupassen.
Du kannst diese Parameter ändern, um die Funktionen nach deinen Bedürfnissen einzustellen.

Konfigurationsdatei

• Die Konfigurationsdatei befindet sich im Ordner shared und heißt config.lua.
• Öffne diese Datei mit einem Texteditor (z. B. Notepad++, Visual Studio Code oder sogar dem Editor 😜).

Hauptparameter

Hier sind die Parameter, die du anpassen kannst:

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

Allgemein

• Debug: Debug-Modus aktivieren (true/false). Wenn aktiviert, werden Debug-Meldungen in der Konsole angezeigt (Client + Server).
• Locale: Sprache der Meldungen (fr, en, de, es).

Benachrichtigungen

• enabled: Alle Benachrichtigungen aktivieren oder deaktivieren (Debug-Logs bleiben erhalten).
• provider: Zu verwendendes Benachrichtigungssystem. auto erkennt automatisch mythic_notify, wasabi_notify, noxen_notify oder okokNotify, ansonsten wird die native GTA-Benachrichtigung (default) verwendet.
• placing / placed / activated / ended / expired / errors: Jeden Benachrichtigungstyp einzeln aktivieren oder deaktivieren (Platzierung läuft, Platzierung erfolgreich, Bomben aktiviert, Rauch beendet, Bombe abgelaufen, Fehler).

Tasten

• place / detonate: Befehl und Standardtaste zum Platzieren und Zünden der Bomben. Setze key = '', um standardmäßig keine Taste zu belegen. Spieler können sie in den FiveM-Einstellungen neu belegen.

Verhalten

• MaxBombsPerPlayer: Maximale Anzahl gleichzeitig platzierter Bomben pro Spieler.
• DetonateRadius: Radius (in Metern) um den Spieler, in dem die Bomben gezündet werden.
• DetonateOnlyOwn: Bei true kann ein Spieler nur seine eigenen Bomben zünden.
• PlaceCooldown: Zeit (in Sekunden) zwischen zwei Platzierungen, serverseitig geprüft.
• DetonateCooldown: Zeit (in Sekunden) zwischen zwei Zündungen, serverseitig geprüft.
• PlaceDistance: Abstand vor dem Spieler, in dem die Bombe platziert wird.
• MaxPlaceDistance: Vom Server erlaubter Maximalabstand zwischen Spieler und Bombe beim Platzieren (Anti-Cheat).
• SmokeDuration: Rauchdauer in Sekunden. Danach wird die Bombe entfernt.
• AutoDeleteTime: Eine nie gezündete Bombe wird nach X Sekunden entfernt (0 = nie).

Interner Vorrat

• enabled: Bei true muss der Spieler Bomben im Vorrat haben (vergeben über den Admin-Befehl oder den Export AddBombs). Bei false ist das Platzieren unbegrenzt. Wird ignoriert, wenn das Inventar-Item aktiv ist.
• giveCommand: Name des Admin-Befehls zum Vergeben von Bomben (/givesmokebomb [id] [anzahl]).

Inventar-Item

• enabled: Ein Inventar-Item verwenden (hat Vorrang vor dem internen Vorrat, wenn die Inventar-Ressource gestartet ist).
• resource: Name der Inventar-Ressource (ox_inventory).
• item: Name des Items. Er muss mit dem in deinem Inventar deklarierten Namen identisch sein.

3D-Modell

• model: Name des Bombenmodells (im Ordner stream/ enthalten). Vanilla-Ersatzmodell: prop_bomb_01.
• zOffset: Vertikale Anpassung, falls das Modell im Boden versinkt oder darüber schwebt.

Animationen

• PlaceAnim: Platzierungsanimation (Dictionary, Name, Dauer in ms, placeAt = Zeitpunkt, an dem die Bombe auf dem Boden erscheint).
• DetonateAnim: Fernbedienungs-Animation (flags = 48 = nur Oberkörper, delay = Verzögerung in ms vor dem Senden der Zündung).

Rauch

• grenadeExplosion: Native Rauchgranaten-Explosion verwenden (Sound und Rauch für alle Spieler synchronisiert).
• explosionType: Explosionstyp (20 = Rauchgranate).
• stagger: Verzögerung (in ms) zwischen der Aktivierung jeder Bombe, damit das Spiel gleichzeitige Explosionen nicht verwirft.
• ptfx: Zusätzlicher Rauch (Partikel), der während SmokeDuration bestehen bleibt, um die Rauchwand zu verdichten: Asset, Name, Versatz, Größe (scale) und Farbe (color, z. B. { r = 255, g = 50, b = 50 } für roten Rauch).

Sounds

• Place / Detonate: Interface-Sounds beim Platzieren und Zünden (Name und Set des GTA-Sounds). Der Rauch-Sound ist der der Granate.

Tipps

• Starte nach jeder Änderung der Konfigurationsdatei das Skript oder den Server neu, damit die Änderungen übernommen werden.
• Wird ein Parameter nicht erkannt, prüfe, ob er richtig geschrieben ist und im richtigen Abschnitt der Datei steht.