Configuration

📜 Client Configuration (config.lua)

This file controls client-side settings, affecting vehicle interactions, impounds, and other in-game features.

config.lua

lib.locale()
Config = {
    Debug = { Prints = true, Zones = false},
    TimeForImpound = 3, -- Time in minutes for vehicle to be impounded
    CallVehicles = true, -- Call vehicles from different garages
    AutomaticlyStartEngine = true, -- Automaticly start engine when player enters the vehicle 
    JobBlipColor = 25, -- Color of the blip for the job garage
    TargetNPCDistance = 4, -- Target distance to open garage
    TargetCarDistance = 4, -- Target distance to store vehicle
    FriendCarSharing = true, -- Vehicle sharing
    VehicleTransfer = true, -- Vehicle transfering between players
    VehicleImagesInTheMenu = true, -- Show vehicle images in the garage menu
    DefaultGarageName = "San Andreas Ave",
    ImpoundsByType = {
        ["car"] = "Impound - City",
        ["boat"] = "Impound - Boats",
        ["air"] = "Impound - Planes",
    },
    SaveVehiclePropsInImpound
    DefaultImpoundName = "Impound - City",
    ImpoundShowOfficerName = true, -- Show officer name in impound window
    ImpoundPrice = 100, -- Price for impound form garage menu
    AutoImpound = {
        enabled = true,         -- Transfer vehicles to the impound if they are not found in the world and are not found in the garage.
        time = 4 * 60 * 1000,   -- How often to check for vehicles that need to be impounded.
    },
    VehiclesWithoutKeys = {
        [`bmx`] = true,
        [`bmxP2`] = true,
        [`cruiser`] = true,
        [`fixter`] = true,
        [`scorcher`] = true,
        [`tribike`] = true,
        [`tribike2`] = true,
        [`tribike3`] = true,
        [`iak_wheelchair`] = true,
        [`serv_electricscooter`] = true,
        [`paulblart`] = true,
        [`elektrovozitko_2`] = true,
        [`paulblartpd`] = true,
        [`elektrovozitko`] = true,
        [`PV_bmwe36`] = true,
        [`PV_rover`] = true,
        [`PV_urus`] = true,
        [`PV_sianr`] = true,
        [`PV_lgss`] = true,
        [`PV_jeep`] = true,
        [`PV_gtr`] = true,
        [`PV_dawn`] = true,
        [`PV_bugvr`] = true,
        [`PV_bugatti`] = true,
    },
    Creator = {
        NpcHash = "s_m_m_dockwork_01",
        DefaultBlip = {
            scale = 0.65,
            color = 3,
            carSprite = 357,
            airSprite = 360,
            boatSprite = 356,
        }
    },
    ImpoundDispatchCall = { -- Call when the player has confiscated vehicle and need officer to get the car out of the impound
        code = "10-58",
        jobs = {'police', 'sheriff', 'sahp'},
        blip = {
            scale = 0.65,
            color = 1,
            sprite = 369,
            name = locale("ui_impound_police_dispatch_blip_name"),
        }
    },
    Impound = {
        NpcAnim = true,
        NpcDriveCoords = vec3(408.81, -1637.90, 29.29),
        NpcHash = 's_m_m_dockwork_01',
        TimeDeleteVehicle = 15000,
        ProgressBarTime = 10000,
        Command = 'odtahnout',
        jobs = {'police', 'sheriff', 'sahp', 'lsfd'},
        anim = {
            clip = nil,
            dict = nil,
            scenario = 'WORLD_HUMAN_CLIPBOARD',
        }
    },
    Keys = {
        Toggle = true, -- Toggle the key system
        Distance = 7,
        NewKeyNPC = {
            {
                price = 5000,
                hash = 'a_m_y_beachvesp_02',
                anim = {
                    clip = nil,
                    dict = nil,
                    scenario = 'WORLD_HUMAN_SMOKING',
                },
                pos = vec4(48.6932,-1594.689,28.5978, 52.21),
                icon = 'fas fa-key',
                time = 30, -- seconds
                Blip = {
                    Sprite = 255,
                    Display = 4,
                    Scale = 0.81,
                    Colour = 0,
                    label = locale("locksmith_title"),
                    ShortRange = true,
                },
            },
        },
        ItemName = "carkeys",
        LockPick = {
            alarmTime = 15000,
            animDict = "anim@amb@clubhouse@tutorial@bkr_tut_ig3@",
            anim = "machinic_loop_mechandplayer",
            item = "lockpick",
            Dispatch = true,
        },
        HotWire = {
            Skills = {
                { { areaSize = 60, speedMultiplier = 1 }, { areaSize = 60, speedMultiplier = 0.5 } }, { '1', '2' }
            },
            animDict = "veh@std@ds@base",
            anim = "hotwire",
            item = "wire_cutters",
        },
    },
    VIN = {
        length = 10,
        allowedChars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789",
        check = {
            commandToggle = true,
            commandName = 'checkvin',
            targetToggle = true,
        },
        scratch = {
            toggle = true,
            npc = {
                {
                    price = 5000,
                    hash = 'a_m_y_beachvesp_02',
                    anim = {
                        clip = nil,
                        dict = nil,
                        scenario = 'WORLD_HUMAN_SMOKING',
                    },
                    pos = vec4(478.0636, -1311.9880, 29.2332, 29.9929),
                    icon = 'fas fa-key',
                    time = 5, -- In minutes
                    Blip = {
                        Sprite = 255,
                        Display = 4,
                        Scale = 0.81,
                        Colour = 0,
                        label = locale("garage_blip_scratch_vin"),
                        ShortRange = true,
                    },
                },
            }
        }
    },
    FakePlate = {
        Command = "plate",
        Distance = 5, -- How far the player can be to take off the plate
        Chance = 50, -- Chance that the lockpick will break after failed minigame
        Duration = 5, -- How long should progress bar take in seconds
        RemoveLockpick = false, -- If the lockpick should be removed after taking off the plate
        LockpickItem = "lockpick", -- Name of the lockpick item
        PlateItem = "plate", -- Name of the plate item
    }
}

Key Settings

• Debug: Enables debugging features.

  • Prints: Outputs debug information in the console.

  • Zones: Debugs garage zones.

• TimeForImpound: Sets how long before a vehicle is impounded (in minutes).

• CallVehicles: Allows calling vehicles from different garages.

• AutomaticlyStartEngine: Automatically starts the engine when entering a vehicle.

• JobBlipColor: Defines the blip color for job garages.

• TargetNPCDistance: The distance required to interact with garage NPCs.

• TargetCarDistance: The distance required to store a vehicle.

• FriendCarSharing: Enables sharing of vehicles with friends.

• VehicleTransfer: Allows transferring vehicles between players.

• DefaultGarageName: The default name for personal garages.

Impound System

• ImpoundsByType: Defines impound locations based on vehicle type.

• DefaultImpoundName: Sets the default impound name.

• SaveVehiclePropsInImpound: Sets if vehicle props should be saved when the vehicle is impounded so they can be restored. So you could take out not functioning vehicle

• ImpoundPrice: Sets the price for retrieving an impounded vehicle.

• ImpoundShowOfficerName: Displays officer names in the impound menu.

• AutoImpound: Automatically impounds vehicles left in the world.

  • enabled: Enables/disables automatic impound.

  • time: Frequency of impound checks (in milliseconds).

Vehicles Without Keys

A list of vehicles that do not require keys to be operated (e.g., bicycles, wheelchairs, certain emergency vehicles).

Creator Settings

Defines default NPCs and blips for garage creation.

• NpcHash: The NPC model used.

• DefaultBlip: Customization for blip appearance.

Impound Dispatch System

Handles notifications when a vehicle is impounded.

• code: Dispatch code for impound requests.

• jobs: Defines which jobs can request impound dispatch.

• blip: Customizes the dispatch blip.

Impound Menu Settings

• NpcAnim: Enables animations for impound NPCs.

• NpcDriveCoords: Coordinates where the NPC will drive impounded vehicles.

• TimeDeleteVehicle: Time (in milliseconds) before the impounded vehicle is deleted.

• ProgressBarTime: Time (in milliseconds) for progress bar during impound process.

• Command: The command used for impounding a vehicle.

• Jobs: Jobs that are allowed to impound vehicles.

Key System

• Toggle: Enables/disables the key system.

• Distance: Defines how far the player can be to lock/unlock the vehicle.

• NewKeyNPC: Settings for NPCs that provide new vehicle keys.

  • Includes price, location, animations, and blip settings.

• LockPick: Configures vehicle lockpicking.

  • alarmTime: Alarm trigger time.

  • animDict & anim: Defines lockpicking animations.

  • item: The required lockpicking tool.

  • Dispatch: Enables police alerts on failed attempts.

• HotWire: Configures hotwiring mechanics.

  • Defines skills, animations, and required tools.

VIN System

• length: VIN number length.

• allowedChars: Defines allowed characters in the VIN.

• check: Toggles commands for checking VIN numbers.

• scratch: Configures VIN scratching (removing identification).

  • Includes NPC settings, pricing, and locations.

Fake Plate System

• Command: The command to remove plates.

• Distance: The required distance for plate removal.

• Chance: The probability of breaking the lockpick.

• Duration: The time taken to remove a plate.

• RemoveLockpick: Whether the lockpick should be removed after failure.

• LockpickItem: The item required for plate removal.

• PlateItem: The item representing the fake plate.

---

📌 Note: Ensure that both config.lua and config_s.lua are properly configured before launching the resource to avoid issues.