Passer au contenu principal
Vérifiez que la ressource tourne :
if GetResourceState('ts-persistence') == 'started' then
    -- Script actif
end

Attention

Véhicules réseau

Les entités véhicule doivent être réseau. Sinon le script renvoie nil ou échoue.

Exports

IsVehiclePersistenceDisabled

Indique si la persistance est désactivée pour ce véhicule.
local isDisabled = exports['ts-persistence']:IsVehiclePersistenceDisabled(vehicle)
ArgumentTypeDescription
vehicleentityEntité véhicule à vérifier.
Retour :
  • boolean : true si la persistance est désactivée, sinon false.

SetVehiclePersistenceDisabled

Active ou désactive la persistance pour un véhicule.
exports['ts-persistence']:SetVehiclePersistenceDisabled(vehicle, state)
ArgumentTypeDescription
vehicleentityEntité véhicule.
statebooleantrue pour désactiver la persistance, false pour l’activer.

CreateVehicle

Crée manuellement les données de persistance pour un véhicule (sinon géré automatiquement).
local id = exports['ts-persistence']:CreateVehicle(vehicle)
ArgumentTypeDescription
vehicleentityEntité véhicule à persister.
Retour :
  • string | nil : ID de persistance si succès, sinon nil.

UpdateVehicle

Met à jour manuellement les données persistées d’un véhicule.
local success = exports['ts-persistence']:UpdateVehicle(vehicle)
ArgumentTypeDescription
vehicleentityEntité véhicule.
Retour :
  • boolean | nil : true si succès, sinon nil.

GetVehiclePersistenceId

Obtient l’ID de persistance d’un véhicule.
local id = exports['ts-persistence']:GetVehiclePersistenceId(vehicle)
ArgumentTypeDescription
vehicleentityEntité véhicule.
Retour :
  • string | nil : ID si trouvé, sinon nil.

GetVehiclePersistenceData

Récupère toutes les données de persistance d’un véhicule.
local data = exports['ts-persistence']:GetVehiclePersistenceData(vehicle)
ArgumentTypeDescription
vehicleentityEntité véhicule.
Retour :
  • table | nil : table de données si trouvée, sinon nil.
La table contient notamment :
  • netId : ID réseau
  • plate : plaque
  • coords : position
  • hash : hash du modèle
  • model : nom du modèle
  • props : propriétés (mods, couleurs)
  • trailer : données remorque
  • doorStatus : verrous
  • damageData : santé et carburant
  • deformation : déformation visuelle (si plugin activé)
Détail des champs : page Structure des données.

ForgetVehicle

Retire complètement l’entrée de persistance (cache + BDD).
local success = exports['ts-persistence']:ForgetVehicle(vehicleId, plate)
ArgumentTypeDescription
vehicleIdstring | nilID de persistance (optionnel si plate fourni).
platestring | nilPlaque (optionnel si vehicleId fourni).
Retour :
  • boolean : true si succès, sinon false.
Last modified on March 29, 2026