Configuration

JustHud offers highly customizable config, with unlimited elements and possibilities to create your unique Hud

Config = {}

Config.Framework = "detect" -- QBCore, ESX, vrp, detect, custom
Config.VoiceChat = "pma" -- saltychat or pma

Config.Compatibility = { -- Replace framework functions ( Notify, ProgressBar ) support ESX and QBCore for now. (it will overwrite fxmanifest.lua from es_extended or qb-core)
    Auto = false,
    Command = "hudcompatibility"
} 

Config.Togglehud = {
    Enable = true,
    Command = "togglehud"
}

Config.HideHudWhileDead = true
Config.HideHudInPause = true

Config.Notification = {
    Progress = true, -- Show the progress of notification
    Style = "bordered", -- solid | bordered | flat
    Legacy = false -- Use legacy notifications
}

Config.Focus = { -- Enable cursor toggle
    Enable = true,
    Key = "TAB"
}

-- Dynamic elements
Config.Elements = {
    {
        id = "hp", -- unique id 
        type = "status", -- type of the element (read docs for more info)
        show = {
            default = true, -- is it visible by default ?
            is_editable = true, -- is it editable from in game settings ?
            settings_title = "Show hp", -- Title in settings for toggling
            in_car = true, -- should it be displayed in vehicles ?
            not_in_car = true -- should it be displayed outside of vehicles ?
        },
        position = { 
            default = { -- default position of element
                bottom = 20,
                left = 1
            },
            is_editable = true -- the position of element is editable ?
        },
        data = "%health%", -- What kind of data it should show ? (read docs for more info)
        icon = "iconsax:Heart:Bulk" -- icons are selectable from iconsax: https://iconsax-react.pages.dev/,
    },
    ... -- More in real config
    -- Custom elements
    -- {
    --     id = "customelement-instance",
    --     type = "custom",
    --     source = "test-element",
    --     args = {
    --         data = "%time%"
    --     },
    --     show = {
    --         default = true,
    --         is_editable = true,
    --         settings_title = "Show custom",
    --         in_car = true,
    --         not_in_car = true,
    --     },
    --     position = {
    --         default = {
    --             bottom = 26,
    --             left = 26
    --         },
    --         is_editable = true
    --     },
    --     icon = "iconsax:Microphone2:Bold"
    -- }
}

Config.Settings = {
    Enable = true,
    Key = "H",
    Options = { -- Set options to nil to disable them in hud settings completely
        colors = {
            primary = "#bdff00",
            secondary = "#ffffff",
            success = "#00ff47",
            danger = "#ff392d",
            warning = "#ffc700",
            info = "#00d1ff"
        },
        is_colors_editable = true, -- Are colors editable ?
        is_position_editable = true,
        global = { -- defualt values of some default settings 
            display_minimap = "show", -- Values: hide,show,oic (only in car)
            display_location = "hide", -- Values: hide,show,oic (only in car)
            speed_unit = "kmh", -- Values: kmh,mph
            sound_volume = 100,
            alert_position = "top-left"
        },
        custom = {
            -- {
            --     id = "custom-settings-id",
            --     title  = "Test",
            --     icon = "iconsax:Heart:Bulk",
            --     type = "button", -- button, range, radio, toggle
            --     default = 10,
            --     items = {"option1", "option2", "option3"},
            --     name = "test"
            -- }
        }
    }
}

Config.Speedlimit = {
    Enable = true,
    Command = "speedlimit",
    Key = "c" -- set nil to disable
}

Config.Stress = {
    Enable = true,
    GainOnShooting = true,
    RelieveTimeout = 1000, -- How much it should pass from last stress gained to start relieve ? (in ms)
    Effects = {
        Blur = { -- Screne blur
            Enable = true,
            Min = 20, -- Minimum stress for effect
            Max = 100, -- Maximum stress for effect
            Duration = 5000, --ms
            Timeout = 10000, --ms
        },
        Shake = { -- Screen shake
            Enable = true,
            Min = 20, -- Minimum stress for effect
            Max = 100, -- Maximum stress for effect
            Timeout = 10000, --ms
        },
        Fall = { -- Fell down
            Enable = true,
            Min = 40, -- Minimum stress for effect
            Max = 100, -- Maximum stress for effect
            Timeout = 10000, --ms
        },
    }
}

Config.ShowGameTime = true

Config.Speedometer = {
    Enable = true,
    BlackListClasses = {},
    UpdateRate = 1500 -- ms 
}

Config.Seatbelt = {
    Enable = true,
    Key = "L",
    BlackListClasses = {},
    PreventActions = true,
    Warning = {
        Enable = true,
        MinimumSpeed = 15,
        Cooldown = 20000
    },
    ToggleNotification = false,
    Sounds = {
        Warning = "tesla.ogg",
        Buckle = "buckle.ogg",
        Unbuckle = "unbuckle.ogg"
    }
}

Config.CarControl = {
    Enable = true,
    Command = "carcontrol",
    Key = "O"
}

Config.Chat = {
    Enable = true,
    PlayerChats = {
        Enable = true,
        EnableChatColors = true,
        distance = -1,
    },
    ShowChatBoxDuration = 5
}

Config.StaffChat = {
    Enable = true,
    Prefix = "^1Staff » ",
    Command = "sc" -- command to send staffchat (or using simple # in the first of messages)
}

-- Admins for chat, broadcasting and staffchat
-- either by giving identifier ace permission (hudAdmin) add_ace group.admin hudAdmin allow
-- or defining identifiers
Config.Admins = {
    "steam:asasas",
    "discord:616734038299770902"
}

Config.TickDuration = 1000

Config.CustomWeapons = { -- Add your custom weapons here (add icons to web/hud-weapons)
    { name = 'custom_weapon1', hash = 1111111 }
}

Config.GtaHud = {
    [1] = false,  --WANTED_STARS
    [2] = false,  --WEAPON_ICON
    [3] = false,  --CASH
    [4] = false,  --MP_CASH
    [5] = true,   --MP_MESSAGE
    [6] = false,  --VEHICLE_NAME
    [7] = false,  --AREA_NAME
    [8] = false,  --VEHICLE_CLASS
    [9] = false,  --STREET_NAME
    [10] = true,  --HELP_TEXT
    [11] = true,  --FLOATING_HELP_TEXT_1
    [12] = true,  --FLOATING_HELP_TEXT_2
    [13] = false, --CASH_CHANGE
    [14] = true,  --RETICLE
    [15] = true,  --SUBTITLE_TEXT
    [16] = true,  --RADIO_STATIONS
    [17] = true,  --SAVING_GAME
    [18] = true,  --GAME_STREAM
    [19] = true,  --WEAPON_WHEEL
    [20] = true,  --WEAPON_WHEEL_STATS
    [21] = true,  --HUD_COMPONENTS
    [22] = true,  --HUD_WEAPONS
}

Config.Lang = {
    ["WALLET"] = "WALLET",
    ["BANK"] = "BANK",
    -- PositionEdit
    ["POS_SAVE_CHANGES"] = "Save Changes",
    ["POS_DISCARD_CHANGES"] = "Discard Changes",
    ["POS_RESET_TO_DEFAULT"] = "Reset to default",
    ["POS_GUIDE"] = "Press ~KEY~ for toggle guide menu",
    ["POS_HUD"] = "HUD",
    ["POS_CAR_HUD"] = "Car Hud",
    ["POSITION_EDIT"] = "Position Edit",
    -- Settings
    ["SETTINGS"] = "Settings",
    ["SETTINGS_DASHBOARD"] = "Dashboard",
    ["SETTINGS_NOT_FOUND"] = "No settings found for",
    ["SETTINGS_SEARCH"] = "Search settings",
    ["SETTINGS_OPTIONS"] = "options",
    ["SETTINGS_THEMING"] = "Theming",
    ["SETTINGS_PRIMARY"] = "Primary Color",
    ["SETTINGS_SECONDARY"] = "Secondary Color",
    ["SETTINGS_SUCCESS"] = "Success Color",
    ["SETTINGS_DANGER"] = "Danger Color",
    ["SETTINGS_WARNING"] = "Warning Color",
    ["SETTINGS_INFO"] = "Info Color",
    ["SETTINGS_GLOBAL"] = "Global",
    ["SETTINGS_VISIBILITY"] = "Visiblity",
    ["SETTINGS_SHOW"] = "Show",
    ["SETTINGS_OIC"] = "Only in car",
    ["SETTINGS_HIDE"] = "Hide",
    ["SETTINGS_MINIMAP"] = "Display Minimap",
    ["SETTINGS_LOCATION"] = "Display Location",
    ["SETTINGS_SPEED_UNIT"] = "Speed Unit",
    ["SETTINGS_KMH"] = "KM/H",
    ["SETTINGS_MPH"] = "MPH",
    ["SETTINGS_ALERT_POSITION"] = "Alert Position",
    ["SETTINGS_SOUND_VOLUME"] = "Sound Volume",
    ["SEATBELT_TOGGLED_ON"] = "Seatbelt toggled on",
    ["SEATBELT_TOGGLED_OFF"] = "Seatbelt toggled off",
    ["SPEEDLIMIT"] = "Speed limit",
    ["SPEEDLIMIT_TOGGLED_ON"] = "Speed limited",
    ["SPEEDLIMIT_TOGGLED_OFF"] = "Speed limit removed",
}

Config.FullZoneNames = {
    ['AIRP'] = "Los Santos International Airport",
    ['ALAMO'] = "Alamo Sea",
    ['ALTA'] = "Alta",
    ['ARMYB'] = "Fort Zancudo",
    ['BANHAMC'] = "Banham Canyon Dr",
    ['BANNING'] = "Banning",
    ['BEACH'] = "Vespucci Beach",
    ['BHAMCA'] = "Banham Canyon",
    ['BRADP'] = "Braddock Pass",
    ['BRADT'] = "Braddock Tunnel",
    ['BURTON'] = "Burton",
    ['CALAFB'] = "Calafia Bridge",
    ['CANNY'] = "Raton Canyon",
    ['CCREAK'] = "Cassidy Creek",
    ['CHAMH'] = "Chamberlain Hills",
    ['CHIL'] = "Vinewood Hills",
    ['CHU'] = "Chumash",
    ['CMSW'] = "Chiliad Mountain State Wilderness",
    ['CYPRE'] = "Cypress Flats",
    ['DAVIS'] = "Davis",
    ['DELBE'] = "Del Perro Beach",
    ['DELPE'] = "Del Perro",
    ['DELSOL'] = "La Puerta",
    ['DESRT'] = "Grand Senora Desert",
    ['DOWNT'] = "Downtown",
    ['DTVINE'] = "Downtown Vinewood",
    ['EAST_V'] = "East Vinewood",
    ['EBURO'] = "El Burro Heights",
    ['ELGORL'] = "El Gordo Lighthouse",
    ['ELYSIAN'] = "Elysian Island",
    ['GALFISH'] = "Galilee",
    ['GOLF'] = "GWC and Golfing Society",
    ['GRAPES'] = "Grapeseed",
    ['GREATC'] = "Great Chaparral",
    ['HARMO'] = "Harmony",
    ['HAWICK'] = "Hawick",
    ['HORS'] = "Vinewood Racetrack",
    ['HUMLAB'] = "Humane Labs and Research",
    ['JAIL'] = "Bolingbroke Penitentiary",
    ['KOREAT'] = "Little Seoul",
    ['LACT'] = "Land Act Reservoir",
    ['LAGO'] = "Lago Zancudo",
    ['LDAM'] = "Land Act Dam",
    ['LEGSQU'] = "Legion Square",
    ['LMESA'] = "La Mesa",
    ['LOSPUER'] = "La Puerta",
    ['MIRR'] = "Mirror Park",
    ['MORN'] = "Morningwood",
    ['MOVIE'] = "Richards Majestic",
    ['MTCHIL'] = "Mount Chiliad",
    ['MTGORDO'] = "Mount Gordo",
    ['MTJOSE'] = "Mount Josiah",
    ['MURRI'] = "Murrieta Heights",
    ['NCHU'] = "North Chumash",
    ['NOOSE'] = "N.O.O.S.E",
    ['OCEANA'] = "Pacific Ocean",
    ['PALCOV'] = "Paleto Cove",
    ['PALETO'] = "Paleto Bay",
    ['PALFOR'] = "Paleto Forest",
    ['PALHIGH'] = "Palomino Highlands",
    ['PALMPOW'] = "Palmer-Taylor Power Station",
    ['PBLUFF'] = "Pacific Bluffs",
    ['PBOX'] = "Pillbox Hill",
    ['PROCOB'] = "Procopio Beach",
    ['RANCHO'] = "Rancho",
    ['RGLEN'] = "Richman Glen",
    ['RICHM'] = "Richman",
    ['ROCKF'] = "Rockford Hills",
    ['RTRAK'] = "Redwood Lights Track",
    ['SANAND'] = "San Andreas",
    ['SANCHIA'] = "San Chianski Mountain Range",
    ['SANDY'] = "Sandy Shores",
    ['SKID'] = "Mission Row",
    ['SLAB'] = "Stab City",
    ['STAD'] = "Maze Bank Arena",
    ['STRAW'] = "Strawberry",
    ['TATAMO'] = "Tataviam Mountains",
    ['TERMINA'] = "Terminal",
    ['TEXTI'] = "Textile City",
    ['TONGVAH'] = "Tongva Hills",
    ['TONGVAV'] = "Tongva Valley",
    ['VCANA'] = "Vespucci Canals",
    ['VESP'] = "Vespucci",
    ['VINE'] = "Vinewood",
    ['WINDF'] = "Ron Alternates Wind Farm",
    ['WVINE'] = "West Vinewood",
    ['ZANCUDO'] = "Zancudo River",
    ['ZP_ORT'] = "Port of South Los Santos",
    ['ZQ_UAR'] = "Davis Quartz"
}