Exemples - Toine Scripts Docs

Quand un véhicule est supprimé par une commande admin ou rangé en garage, il faut souvent le retirer de la persistance pour qu’il ne réapparaisse pas plus tard.
Voici des exemples avec l’export ForgetVehicle.

Commande supprimer véhicule (`/dv`)

Si vous supprimez un véhicule à la main, retirez-le de la persistance pour éviter qu’il soit restauré automatiquement.

QBCore
ESX

Ajoutez : exports['ts-persistence']:ForgetVehicle(nil, QBCore.Functions.GetPlate(veh))

resources/[qb]/qb-core/client/events.lua

    RegisterNetEvent('QBCore:Command:DeleteVehicle', function()
        local ped = PlayerPedId()
        local veh = GetVehiclePedIsUsing(ped)
        if veh ~= 0 then
            -- Retirer le véhicule de la persistance
            exports['ts-persistence']:ForgetVehicle(nil, QBCore.Functions.GetPlate(veh))
            
            SetEntityAsMissionEntity(veh, true, true)
            DeleteVehicle(veh)
        else
            local pcoords = GetEntityCoords(ped)
            local vehicles = GetGamePool('CVehicle')
            for _, v in pairs(vehicles) do
                if #(pcoords - GetEntityCoords(v)) <= 5.0 then
                    -- Retirer le véhicule de la persistance
                    exports['ts-persistence']:ForgetVehicle(nil, QBCore.Functions.GetPlate(v))
                    
                    SetEntityAsMissionEntity(v, true, true)
                    DeleteVehicle(v)
                end
            end
        end
    end)

Ajoutez avant DeleteEntity(Vehicle) :

local plate = GetVehicleNumberPlateText(Vehicle)
if not plate or plate == "" then
    print("Aucune plaque pour le véhicule " .. tostring(Vehicle))
else
    local success = exports['ts-persistence']:ForgetVehicle(nil, plate, true)
    if not success then print("Échec ForgetVehicle " .. tostring(Vehicle)) end
end

[core]\es_extended\server\modules\commands.lua:113-173

    ESX.RegisterCommand(
        { "cardel", "dv" },
        "admin",
        function(xPlayer, args)
            local ped = GetPlayerPed(xPlayer.source)
            local pedVehicle = GetVehiclePedIsIn(ped, false)

            if DoesEntityExist(pedVehicle) then
                local plate = GetVehicleNumberPlateText(pedVehicle)
                if not plate or plate == "" then
                    print("No plate found for vehicle " .. tostring(pedVehicle))
                else
                    local success = exports['ts-persistence']:ForgetVehicle(nil, plate, true)
                    if not success then print("Failed to forget vehicle " .. tostring(pedVehicle)) end
                end
                DeleteEntity(pedVehicle)
            end

            local coords = GetEntityCoords(ped)
            local Vehicles = ESX.OneSync.GetVehiclesInArea(coords, tonumber(args.radius) or 5.0)
            for i = 1, #Vehicles do
                local Vehicle = NetworkGetEntityFromNetworkId(Vehicles[i])
                if DoesEntityExist(Vehicle) then

                    local plate = GetVehicleNumberPlateText(Vehicle)
                    if not plate or plate == "" then
                        print("Aucune plaque pour le véhicule " .. tostring(Vehicle))
                    else
                        local success = exports['ts-persistence']:ForgetVehicle(nil, plate, true)
                        if not success then print("Échec ForgetVehicle " .. tostring(Vehicle)) end
                    end

                    DeleteEntity(Vehicle)
                end
            end
            if Config.AdminLogging then
                ESX.DiscordLogFields("UserActions", "Delete Vehicle /dv Triggered!", "pink", {
                    { name = "Player", value = xPlayer and xPlayer.name or "Server Console", inline = true },
                    { name = "ID",     value = xPlayer and xPlayer.source or "Unknown ID",   inline = true },
                })
            end
        end,
        false,
        {
            help = TranslateCap("command_cardel"),
            validate = false,
            arguments = {
                { name = "radius", validate = false, help = TranslateCap("command_cardel_radius"), type = "number" },
            },
        }
    )

Synchroniser l’etat de verrouillage des portes

Quand votre script de cles verrouille/deverrouille un vehicule, mettez aussi a jour ts-persistence avec : exports['ts-persistence']:UpdateDoorStatus(vehicle, status)

status = 2 pour verrouiller
status = 1 pour deverrouiller

Exemple avec lfKeys (meme logique a appliquer a n’importe quel script de cles) :

if locked == 1 or locked == 0 then
    -- votre logique de lock
    exports['ts-persistence']:UpdateDoorStatus(vehicle, 2)
elseif locked == 2 then
    -- votre logique d'unlock
    exports['ts-persistence']:UpdateDoorStatus(vehicle, 1)
end

Important : l’exemple lfKeys est seulement une reference.
Pour tout autre script de cles, appelez simplement UpdateDoorStatus juste apres le changement de statut des portes.

Intégration à un système de garage

Lorsqu’un véhicule est correctement rangé, appelez l’export pour qu’il ne soit plus restauré par la persistance. Exemple avec qb-garages quand un véhicule est déposé :

QBCore
ESX

Ajoutez : exports['ts-persistence']:ForgetVehicle(nil, plate)

resources/[qb]/qb-garages/client/main.lua

    local function DepositVehicle(veh, data)
        local plate = QBCore.Functions.GetPlate(veh)
        QBCore.Functions.TriggerCallback('qb-garages:server:canDeposit', function(canDeposit)
            if canDeposit then
                local bodyDamage = math.ceil(GetVehicleBodyHealth(veh))
                local engineDamage = math.ceil(GetVehicleEngineHealth(veh))
                local totalFuel = exports[Config.FuelResource]:GetFuel(veh)
                TriggerServerEvent('qb-mechanicjob:server:SaveVehicleProps', QBCore.Functions.GetVehicleProperties(veh))
                TriggerServerEvent('qb-garages:server:updateVehicleStats', plate, totalFuel, engineDamage, bodyDamage)
                
                -- Retirer le véhicule de la persistance
                exports['ts-persistence']:ForgetVehicle(nil, plate)
                
                CheckPlayers(veh)
                if plate then TriggerServerEvent('qb-garages:server:UpdateOutsideVehicle', plate, nil) end
                QBCore.Functions.Notify(Lang:t('success.vehicle_parked'), 'primary', 4500)
            else
                QBCore.Functions.Notify(Lang:t('error.not_owned'), 'error', 3500)
            end
        end, plate, data.type, data.indexgarage, 1)
    end

Ajoutez avant ESX.Game.DeleteVehicle(vehicle) : exports['ts-persistence']:ForgetVehicle(nil, ESX.Game.GetPlate(vehicle))

[esx_addons]\esx_garage\client\main.lua:344-359

    if isInVehicle then
        if IsControlJustReleased(0, 38) then
            local vehicle = GetVehiclePedIsIn(playerPed, false)
            local vehicleProps = ESX.Game.GetVehicleProperties(vehicle)
            ESX.TriggerServerCallback('esx_garage:checkVehicleOwner', function(owner)
                if owner then
                    exports['ts-persistence']:ForgetVehicle(nil, ESX.Game.GetPlate(vehicle))
                    ESX.Game.DeleteVehicle(vehicle)
                    TriggerServerEvent('esx_garage:updateOwnedVehicle', true, currentMarker, nil,
                        {vehicleProps = vehicleProps})
                else
                    ESX.ShowNotification(TranslateCap('not_owning_veh'), 'error')
                end
            end, vehicleProps.plate)
        end
    end

Pour commencer

Scripts

​Commande supprimer véhicule (/dv)

​Synchroniser l’etat de verrouillage des portes

​Intégration à un système de garage

Commande supprimer véhicule (`/dv`)

Synchroniser l’etat de verrouillage des portes

Intégration à un système de garage