Installation

Logging in to the CFX Portal

First, log in to the official CFX portal by clicking here.

Finding Your Assets

Once logged in, navigate to the Granted Assets section to access your purchased assets. You can download them by clicking the "Download" button.

progressbar

GitHub - quasar-scripts/progressbar: Progressbar system created by Quasar ScriptsGitHub

ox_lib

Releases · overextended/ox_libGitHub

cfx-natives (baseevents)

GitHub - citizenfx/cfx-server-data: Data repository for CitizenFX servers.GitHub

Update Artifacts

Completely replace your current artifacts with the latest version. Download the appropriate artifacts for your operating system from the official links:

• Windows: Windows Artifacts.

• Linux: Linux Artifacts.

Update Gamebuild

Using the latest gamebuild is critical to take advantage of the newest features and avoid compatibility errors.

Edit the server.cfg file and add the following line:

sv_enforceGameBuild 3258

Using print Statements for Debug

You can use print() statements to display the values of variables in the console. This is particularly useful when you’re unsure of the data being returned or when you need to verify the behavior of your code. Here are two examples:

-- Printing multiple values separated by commas
print(vehicleData.model, vehicleData.name, vehicleData.other)

-- Including descriptive labels for clarity
print('Model: ', vehicleData.model, 'Name: ', vehicleData.name)

This approach helps identify whether specific variables are returning the expected values.

Example Debugging Scenario in a Callback

In complex scripts, such as when purchasing a vehicle, you might want to validate the data being processed. Using print() statements inside callbacks can reveal any unexpected issues.

ESX.TriggerServerCallback('esx_vehicleshop:buyVehicle', function(success)
    if success then
        IsInShopMenu = false
        menu2.close()
        menu.close()
        DeleteDisplayVehicleInsideShop()
        FreezeEntityPosition(playerPed, false)
        SetEntityVisible(playerPed, true)

        -- Debugging vehicle data
        print('Model: ', vehicleData.model, 'Name: ', vehicleData.name, 'Other: ', vehicleData.other)
    else
        ESX.ShowNotification(TranslateCap('not_enough_money'))
    end
end, vehicleData.model, generatedPlate)

By adding debugging prints, you can determine if the vehicle data (e.g., vehicleData.model, generatedPlate) is correct before proceeding with the rest of the logic.

Retrieve Vehicle Model and Plate

If you need to get the model name or plate of a vehicle, you can use the following native functions. These are simple yet powerful tools for obtaining vehicle information directly:

local model = GetDisplayNameFromVehicleModel(GetEntityModel(veh)) -- Returns the vehicle model name
local plate = GetVehicleNumberPlateText(veh) -- Returns the vehicle's license plate

These functions can be integrated into your scripts to quickly fetch the necessary details about a vehicle.

Best Practices for Debugging

1. Place print() Strategically: Add print() statements before and after key operations to understand the flow of your code.

2. Label Debug Outputs: Use descriptive text in print() to make debugging outputs easier to read.

   Copy

   print('Current Vehicle Model:', model)
   print('Current Vehicle Plate:', plate)

3. Test Incrementally: Test small portions of your script to isolate errors and verify logic step by step.

By following these practices, you’ll streamline your debugging process and ensure that your vehicle scripts operate as intended. Debugging effectively not only saves time but also enhances the reliability and performance of your code.

Export Overview

The GiveKeys export assigns keys to a specified vehicle. It accepts the following parameters:

exports['qs-vehiclekeys']:GiveKeys(plate, model, true)

• plate: The vehicle's license plate.

• model: The vehicle's model name.

• bypassKeyCheck: (optional, default false) If set to true, the export bypasses the key validation check.

Implementation Example

Below is an example of integrating the GiveKeys export within esx_vehicleshop. This code ensures that once a vehicle is purchased, keys are automatically assigned to the buyer:

ESX.TriggerServerCallback('esx_vehicleshop:buyVehicle', function(success)
    if success then
        IsInShopMenu = false
        menu2.close()
        menu.close()
        DeleteDisplayVehicleInsideShop()
        FreezeEntityPosition(playerPed, false)
        SetEntityVisible(playerPed, true)

        -- Retrieve the vehicle's model and plate using natives
        local model = GetDisplayNameFromVehicleModel(GetEntityModel(vehicleData))
        local plate = GetVehicleNumberPlateText(vehicleData)

        -- Grant keys to the buyer
        exports['qs-vehiclekeys']:GiveKeys(plate, model, true)
        
    else
        ESX.ShowNotification(TranslateCap('not_enough_money'))
    end
end, vehicleData.model, generatedPlate)

Key Points for Integration

1. Dynamic Plate and Model Retrieval:

   • Use natives like GetDisplayNameFromVehicleModel and GetVehicleNumberPlateText to dynamically fetch the vehicle's model and plate.

2. Export Usage:

   • Call GiveKeys with the retrieved plate and model values, and set bypassKeyCheck as true if necessary.

3. Custom Implementation:

   • While this example uses esx_vehicleshop, the logic can be adapted for any third-party asset where key assignment is needed.

By integrating the GiveKeys export in your scripts, you can enhance the gameplay experience by automatically assigning keys upon vehicle purchase or spawn.