⚙️Configuration

Configuration guide of Wallet System V2 System.

---

Config.lua

Config = {}

-- ═══════════════════════════════════════════
--  SERVER
-- ═══════════════════════════════════════════
Config.Language = 'en' -- en, de, fr, es, pt, it, nl, pl, sv, ar, jp, zh, he, fi, no
Config.Theme = "blue" -- blue, red, green, purple, orange, pink, yellow, cyan, white, custom (you can customize the 'custom' theme colors in web/themes/custom.css under)
Config.ServerName = { 'SERVER', 'NAME' }
Config.ServerDescription = 'Experience the ultimate roleplay adventure with endless possibilities and a thriving community.'
Config.CurrencySymbol = '$' -- $, €, £, ¥, etc.
Config.SpeedType = 'kmh'              -- 'kmh' or 'mph'

-- ═══════════════════════════════════════════
--  FEATURES (toggle on/off)
-- ═══════════════════════════════════════════
Config.Features = {
    -- HUD Sections
    location = true,                   -- Street name and area info
    teamInfo = true,                   -- Job, role and date panel
    statusBars = true,                 -- Health, food and water indicators
    playerInfo = true,                 -- Player ID and server info
    cash = true,                       -- Cash balance display
    bank = true,                       -- Bank balance display
    blackMoney = true,                 -- Black money balance display
    weapon = true,                     -- Weapon name and ammo display
    speedometer = true,                -- Speed gauge and vehicle info

    -- Systems
    chat = true,                       -- Chat system (OOC, admin, team)
    notifications = true,              -- Notification system (exports & events)
    progressBar = true,                -- Progress bar system
    helpNotify = true,                 -- Help notify prompts (key + message popup)
    helpKeys = true,                   -- Help keys section on HUD
    announcement = true,               -- Announcement command system
    seatbelt = true,                   -- Seatbelt system
    nitro = true,                      -- Nitro system
    alwaysMinimap = false,             -- Show minimap even when not in a vehicle
}

-- ═══════════════════════════════════════════
--  CHAT
-- ═══════════════════════════════════════════
Config.UseChat = {
    ooc = true,                        -- OOC (normal) chat
    admin = true,                      -- Admin chat (visible only to admin groups)
    team = true,                       -- Team chat (visible only to same job/faction)
    adminGroups = {
        ['god'] = 'God',
        ['admin'] = 'Admin',
        ['superadmin'] = 'Super Admin',
    },
}

-- ═══════════════════════════════════════════
--  ANNOUNCEMENT
-- ═══════════════════════════════════════════
Config.Announcement = {
    command = 'announce',              -- /announce [duration_seconds] [message]
    targetCommand = 'announceto',      -- /announceto [id] [duration_seconds] [message]
    permission = { 'admin', 'superadmin', 'god' },
    DefaultName = 'System',
    DefaultTitle = 'ANNOUNCEMENT',
    DefaultDuration = 10000,           -- ms
    UseCharacterNameFallback = true,

    txAdmin = {
        active = true,                 -- Enable txAdmin announcement/restart integration
        name = 'txAdmin',
        duration = 15000,              -- ms
    },
}

-- ═══════════════════════════════════════════
--  SEATBELT
-- ═══════════════════════════════════════════
Config.Belt = {
    key = 'B',
}

-- ═══════════════════════════════════════════
--  NITRO
-- ═══════════════════════════════════════════
Config.Nitro = {
    boostKey = 'LSHIFT',
    boostMultiplier = 2.0,
    drainRate = 5.0,                   -- Per tick (out of 100)
    drainInterval = 1000,              -- ms
    installTime = 5000,                -- Progress bar duration (ms)
    itemName = 'nos',
    installOutsideOnly = true,
    activationDelay = 500,             -- ms, prevents accidental activation
}

-- ═══════════════════════════════════════════
--  HELP KEYS
-- ═══════════════════════════════════════════
Config.HelpKeys = {
    keys = {
        { key = 'E', title = 'INTERACT', desc = 'Interact with objects' },
        { key = 'F', title = 'ENTER VEHICLE', desc = 'Enter/exit vehicles' },
        { key = 'F1', title = 'INVENTORY', desc = 'Open your inventory' },
    }
}

-- ═══════════════════════════════════════════
--  HUD SETTINGS PANEL
-- ═══════════════════════════════════════════
Config.Settings = {
    active = true,
    command = 'hud',
}

-- ═══════════════════════════════════════════
--  INTERVALS (ms)
-- ═══════════════════════════════════════════
Config.Intervals = {
    status = 500,                      -- Health, food, water update
    speedo = 100,                      -- Speedometer update
    street = 3666,                     -- Street/area name update
    weapon = 500,                      -- Weapon info update
    beltWarning = 200,                 -- Seatbelt warning check
    nitroVehicleCheck = 500,           -- Nitro vehicle enter/exit check
    playerCount = 60000,               -- Player count refresh (server-side)
    moneyChange = 3000,                -- Money change notification display duration
}

-- ═══════════════════════════════════════════
--  FUEL
-- ═══════════════════════════════════════════
Config.GetFuel = function(vehicle)
    if not DoesEntityExist(vehicle) then return 0 end
    if GetResourceState('ox_fuel') == 'started' then
        return Entity(vehicle).state.fuel or 0
    end
    if GetResourceState('LegacyFuel') == 'started' then
        return exports['LegacyFuel']:GetFuel(vehicle) or 0
    end
    if GetResourceState('cdn-fuel') == 'started' then
        return exports['cdn-fuel']:GetFuel(vehicle) or 0
    end
    if GetResourceState('ps-fuel') == 'started' then
        return exports['ps-fuel']:GetFuel(vehicle) or 0
    end
    if GetResourceState('stg-fuel') == 'started' then
        return exports['stg-fuel']:GetFuel(vehicle) or 0
    end
    return GetVehicleFuelLevel(vehicle) or 0
end