shared/config.lua. Cette page explique chaque réglage.
[!NOTE] Vous cherchez les options Framework, Garage ou Clés ?
ts-persistence est totalement indépendant : tous les ponts (QBCore, ESX, qs-vehiclekeys, qb-garages, etc.) sont gérés uniquement parts-lib. Paramétrez-les dansts-lib/shared/config.lua.
Paramètres du pont
Si
true, le script synchronise la déformation visuelle des véhicules via le plugin VehicleDeformation. Plus d’infos ici.Paramètres globaux
Si activé, une remorque attachée à un véhicule est aussi sauvegardée et restaurée au spawn du véhicule principal.
Si activé, tous les véhicules deviennent permanents : ils ne sont plus supprimés après un redémarrage ou un restart du script.
Paramètres client
Active ou désactive les logs de debug client dans la console F8.
Fonction pour lire le niveau de carburant. Par défaut : native
GetVehicleFuelLevel.Fonction pour appliquer le niveau de carburant. Les scripts custom (ex. LegacyFuel) peuvent s’intégrer ici.
Distance (unités de jeu) à laquelle un véhicule persistant commence à apparaître quand un joueur s’approche, s’il n’était pas déjà spawné.
Temps max (ms) pendant lequel le client attend que l’entité véhicule existe après le déclenchement du spawn serveur. Ne modifiez pas sans savoir pourquoi.
Temps max (ms) pour obtenir le contrôle réseau du véhicule spawné avant abandon. Ne modifiez pas sans savoir pourquoi.
Nombre de tentatives pour réappliquer les propriétés (mods, couleurs) si une incohérence est détectée après spawn. Défaut : 1. Ne modifiez pas sans savoir pourquoi.
Gère le verrouillage local des portes. Reçoit l’état de verrou GTA brut (1 = déverrouillé, 2 = verrouillé, etc.). Voir FiveM Natives.
Fonction retournant
true ou false. Si true, aucun véhicule ne spawn pour ce joueur (cinématiques, certains états).Paramètres serveur
Active ou désactive les logs de debug serveur dans la console.
Fonction serveur pour déterminer le type de véhicule au spawn (ex.
automobile, boat, heli). Par défaut : pont framework TS.Bridge.GetVehicleType(model).Vérifie si une plaque (et
netId optionnel) correspond à un véhicule possédé. Sert à décider si le véhicule est temporaire ou permanent.Plus d’infos : section Performance & optimisation sur la page Dépannage.
Active ou désactive l’auto-sauvegarde. Si activé, les véhicules sont enregistrés en BDD à intervalles réguliers.
Intervalle (en minutes) entre les sauvegardes automatiques. S’applique seulement si
Config.Server.autoSaveActive est true.Active ou désactive la suppression basée sur l’âge du véhicule.
Âge (en minutes) au-delà duquel les véhicules temporaires sont supprimés. Ex.
120 = 2 heures. false pour désactiver. S’applique si Config.Server.timeToDeleteActive est true.Âge (en minutes) pour supprimer les véhicules permanents.
false pour ne jamais supprimer les permanents. Si timeToDeleteActive est activé.Intervalle (minutes) entre les vérifications de suppression. Si
timeToDeleteActive est activé.Si
true, les véhicules spawnés par la persistance sont marqués « dehors » pour un comportement cohérent en jeu.Si
true, tous les véhicules persistés sont envoyés aux clients connectés au démarrage de la ressource pour alimenter tout de suite la grille côté client.Callback serveur déclenché juste après la création d’un véhicule. Utile pour le modifier après spawn.
Verrouillage côté serveur et synchro avec les scripts de clés (ex.
qb-vehiclekeys). Met à jour le state bag isLocked.Callback pour afficher des notifications. Reçoit la source du joueur, un message et un type optionnel (ex.
success, error).