Agency-Seatbelt

01 Configuration

Complete config.lua for Agency-Seatbelt. All options documented via inline comments.

Config = {}

-- [[ 1. GENERAL SETTINGS ]]
Config.Locale = 'de' 
Config.Framework = 'standalone' -- Options: 'qbcore', 'esx', 'standalone'
Config.EnableNotifications = true
Config.UseAgencyNotify = true -- Use Agency-Notify system (default: true, fallback to built-in if false)
Config.Key = 311 -- Default key is 'K' (can be changed to any key code)
Config.DebugMode = false -- Enable debug console output (default: false)

-- [[ 2. SOUND SETTINGS ]]
Config.SoundVolume = 0.8 -- Volume for seatbelt sounds (0.0 - 1.0)
Config.Enable3DSounds = true -- Enable 3D positioned sounds
Config.SoundDistance = 10.0 -- Maximum distance to hear seatbelt sounds

-- [[ 2.1 CUSTOM SEATBELT SOUNDS ]]
-- Configure custom GTA sounds for seatbelt actions
Config.SeatbeltSounds = {
    buckle = {
        soundName = "CLICK_BACK", -- Sound name to play when unbuckling seatbelt
        soundSet = "WEB_NAVIGATION_SOUNDS_PHONE" -- Sound set/library
    },
    unbuckle = {
        soundName = "CLICK_BACK", -- Sound name to play when unbuckling seatbelt
        soundSet = "WEB_NAVIGATION_SOUNDS_PHONE" -- Sound set/library
    },
    reminder = {
        soundName = "Beep_Red", -- Sound name to play for seatbelt reminder
        soundSet = "DLC_HEIST_HACKING_SNAKE_SOUNDS" -- Sound set/library
    }
}

-- [[ 2.2 AVAILABLE GTA V SOUNDS REFERENCE ]]
-- Hier ist eine Liste der verfügbaren GTA V Sounds, die du verwenden kannst:
--[[
    HÄUFIG VERWENDETE SOUNDS:

    === UI/MENU SOUNDS ===
    • Sound: "CLICK_BACK" | Set: "WEB_NAVIGATION_SOUNDS_PHONE"
    • Sound: "CLICK_SPECIAL" | Set: "WEB_NAVIGATION_SOUNDS_PHONE" 
    • Sound: "NAV_UP_DOWN" | Set: "HUD_FRONTEND_DEFAULT_SOUNDSET"
    • Sound: "SELECT" | Set: "HUD_FRONTEND_DEFAULT_SOUNDSET"
    • Sound: "CANCEL" | Set: "HUD_FRONTEND_DEFAULT_SOUNDSET"
    • Sound: "ERROR" | Set: "HUD_FRONTEND_DEFAULT_SOUNDSET"

    === BEP/ALARM SOUNDS ===
    • Sound: "Beep_Red" | Set: "DLC_HEIST_HACKING_SNAKE_SOUNDS"
    • Sound: "BEEP" | Set: "RESPAWN_ONLINE_SOUNDSET"
    • Sound: "TIMER_STOP" | Set: "HUD_MINI_GAME_SOUNDSET"
    • Sound: "5_SEC_WARNING" | Set: "HUD_MINI_GAME_SOUNDSET"
    • Sound: "CHECKPOINT_NORMAL" | Set: "HUD_MINI_GAME_SOUNDSET"

    === FAHRZEUG SOUNDS ===
    • Sound: "CAR_DOOR_CLOSE" | Set: "VEHICLES_EFFECTS_SOUNDSET"
    • Sound: "CAR_DOOR_OPEN" | Set: "VEHICLES_EFFECTS_SOUNDSET"
    • Sound: "ENGINE_START" | Set: "VEHICLES_EFFECTS_SOUNDSET"
    • Sound: "SEATBELT" | Set: "VEHICLES_EFFECTS_SOUNDSET"
    • Sound: "HANDBRAKE_ON" | Set: "VEHICLES_EFFECTS_SOUNDSET"

    === WARNUNGS SOUNDS ===
    • Sound: "CHECKPOINT_MISSED" | Set: "HUD_MINI_GAME_SOUNDSET"
    • Sound: "LOSE_1ST" | Set: "GTAO_FM_EVENTS_SOUNDSET"
    • Sound: "CHALLENGE_UNLOCKED" | Set: "HUD_AWARDS"
    • Sound: "OTHER_TEXT" | Set: "HUD_AWARDS"

    === KLICK/MECHANISCHE SOUNDS ===
    • Sound: "TOGGLE_ON" | Set: "HUD_FRONTEND_DEFAULT_SOUNDSET"    
    • Sound: "TOGGLE_OFF" | Set: "HUD_FRONTEND_DEFAULT_SOUNDSET"
    • Sound: "WEAPON_SELECT_ARMOR" | Set: "HUD_AMMO_SHOP_SOUNDSET"
    • Sound: "PICK_UP" | Set: "HUD_FRONTEND_DEFAULT_SOUNDSET"
    • Sound: "PUT_DOWN" | Set: "HUD_FRONTEND_DEFAULT_SOUNDSET"

    === POSITIVE FEEDBACK ===
    • Sound: "WAYPOINT_SET" | Set: "HUD_FRONTEND_DEFAULT_SOUNDSET"
    • Sound: "MEDAL_BRONZE" | Set: "HUD_AWARDS"
    • Sound: "MEDAL_SILVER" | Set: "HUD_AWARDS"
    • Sound: "MEDAL_GOLD" | Set: "HUD_AWARDS"

    === SPEZIELLE EFFEKT SOUNDS ===
    • Sound: "POWER_UP" | Set: "RESPAWN_ONLINE_SOUNDSET"
    • Sound: "MP_WAVE_COMPLETE" | Set: "HUD_FRONTEND_DEFAULT_SOUNDSET"
    • Sound: "BASE_JUMP_PASSED" | Set: "HUD_AWARDS"
    • Sound: "FLIGHT_SCHOOL_LESSON_PASSED" | Set: "HUD_AWARDS"

    VERWENDUNG:
    Ändere einfach die Werte in Config.SeatbeltSounds:
    
    Beispiel für Anschnallen mit Fahrzeug-Sound:
    buckle = {
        soundName = "SEATBELT",
        soundSet = "VEHICLES_EFFECTS_SOUNDSET"
    }
    
    Beispiel für Warnung mit Alarm-Sound:
    reminder = {
        soundName = "5_SEC_WARNING", 
        soundSet = "HUD_MINI_GAME_SOUNDSET"
    }
--]]

-- [[ 3. MULTI-OCCUPANT SYSTEM ]]
Config.EnableMultiOccupant = true -- Allow all passengers to use seatbelts
Config.ShowOccupancyDisplay = false -- Show vehicle occupancy in UI (DISABLED for clean experience)
Config.ShowSeatbeltStatus = false -- Show personal seatbelt status (DISABLED for clean experience)
Config.EnableSync = false -- Enable multiplayer synchronization (requires server events)
Config.MaxPassengers = 7 -- Maximum number of passengers to track (0-7)

-- [[ 4. EJECTION SYSTEM ]]
Config.EnableEjectionSystem = true
Config.EjectionSpeedThreshold = 65.0 -- Minimum speed (km/h) for ejection
Config.DecelerationThreshold = 40.0 -- Minimum deceleration for ejection
Config.EjectionForceMultiplier = 1.2 -- Multiplier for ejection force
Config.EnableRandomEjection = true -- Add randomness to ejection physics

-- [[ 5. EJECTION DAMAGE ]]
Config.EnableEjectionDamage = true
Config.EjectionDamage = 45 -- Base damage for ejection
Config.RandomDamageVariation = 15 -- Random damage variation (+/-)
Config.EnableEjectionEffects = true -- Visual effects for ejection

-- [[ 6. SEATBELT REMINDER ]]
Config.EnableSeatbeltReminder = true
Config.ReminderSpeedKmh = 25 -- Speed threshold for reminders
Config.ReminderInterval = 4000 -- Time between reminders (ms)
Config.EnableVisualReminder = true -- Show visual reminder in UI
Config.EnableAudioReminder = true -- Play audio reminder
Config.ReminderIntensity = 'medium' -- Options: 'low', 'medium', 'high'

-- [[ 7. UI SETTINGS ]]
Config.UITheme = 'modern' -- Options: 'classic', 'modern', 'minimal'
Config.UIPosition = 'bottom-right' -- Options: 'top-left', 'top-right', 'bottom-left', 'bottom-right', 'center'
Config.UIScale = 1.0 -- UI scale factor (0.5 - 2.0)
Config.EnableAnimations = true -- Enable UI animations
Config.AnimationSpeed = 'normal' -- Options: 'slow', 'normal', 'fast'
Config.ShowSpeedometer = true -- Show current speed in reminder
Config.EnableGlow = true -- Enable glow effects

-- [[ 8. ADVANCED SETTINGS ]]
Config.EnableDebug = false -- Enable debug mode
Config.UpdateInterval = 100 -- Main thread update interval (ms)
Config.VehicleClassExclusions = { 13, 14, 15, 16 } -- Vehicle classes to exclude (boats, helicopters, planes, etc.)
Config.EnableVehicleSpecificSettings = false -- Enable per-vehicle type settings

-- [[ 9. KEYBIND SETTINGS ]]
Config.AllowKeybindChange = true -- Allow players to change keybind
Config.AlternativeKeys = { 311, 38 } -- Alternative keys (K, E)

-- [[ 10. PERFORMANCE SETTINGS ]]
Config.OptimizeForLowEnd = false -- Optimize for low-end systems
Config.ReduceEffects = false -- Reduce visual effects for performance
Config.MaxRenderDistance = 100.0 -- Maximum render distance for effects